Getting Started

This page shall help you start using Valetudo. Make sure that you’ve read the newcomer guide. If you haven’t done that already please do so and then come back here.

You may also want to read the Why Valetudo? and Why not Valetudo? pages before continuing with this guide.

Table of Contents

  1. Choosing a robot
  2. Installing Valetudo
  3. Joining Wifi
  4. Using Valetudo
  5. Now What?

Choosing a robot

First, you’ll need to acquire a supported robot. There are many ways to do that, but usually they involve you paying money. To not waste all that hard-earned money, please make sure to thoroughly read the buying supported robots docs page.

Please refrain from buying any random robot just to then ask how we can make Valetudo on that thing happen.

Installing Valetudo

After you’ve acquired your supported vacuum robot, the next step is to do a simple test run before you void your warranty. Usually it’s possible to simply use the buttons on the robot to start a cleanup. No need to use an official app.

If everything seems to be working fine with no unexpected error messages, weird behaviour or things catching fire, you can now start following the rooting instructions for your supported robot.

Joining Wifi

With your robot rooted and Valetudo installed, the next step is to join your robot to your Wi-Fi network so that you can interact with it. To do that, please do not execute any random shell commands or edit some config files as that often leads to breakage.

Instead, you should use Valetudo for that. Simply connect to the Wi-Fi AP of your now rooted robot and open its IP in your browser:

The IP may vary based on your model of robot. Usually, it’s either http://192.168.5.1 or http://192.168.8.1. Note that some browsers might try redirecting you to https:// without you noticing.

On recent versions of Android, don’t forget to disable mobile data and click through about seven nagscreens as otherwise the OS will not route any traffic to the Wi-Fi AP as it doesn’t provide any internet connectivity.

If you’re still facing issues connecting to Valetudo, you can also use the android companion app and follow the instructions there after pressing the + button on the bottom right.

Using Valetudo

With your Valetudo-enabled robot being connected to your home network, you can now start using it by simply opening its webinterface in the browser of your choice unless your choice is the Internet Explorer.

If you don’t know how to find said Webinterface, you can use the android companion app, which will autodiscover Valetudo instances on your network.

If you’re using a computer running Microsoft Windows, you can also open the explorer and navigate to “Network” where your new robot should also be autodiscovered.

image

Now What?

Congratulations! You have now significantly increased the baseline cleanliness of your living space.

It is strongly recommended to now connect Valetudo to the home automation system of your choice such as OpenHab or Home Assistant.

Using that, you can now do things such as

and more.

Also, consider checking out the companion apps section of the docs where you can find stuff like Valeronoi, which can build a Wi-Fi signal heatmap from the data provided by Valetudo.

Or maybe you’re interested in importing your floor plan into minecraft or the source game engine?

Valetudo

Cloud replacement for vacuum robots enabling local-only operation

View the Project on GitHub Hypfer/Valetudo

General

Newcomer Guide Why Valetudo? Why not Valetudo? Getting Started Supported Robots Rooting Essentials Buying Supported Robots

Installation

Dreame Roborock

Usage

Implementation Overview Capabilities Overview Upgrading Firmware Updates

Companion Apps

Valetudo Companion (Android) Valetudo Tray Companion Valeronoi Lovelace Valetudo Map Card I Can't Believe It's Not Valetudo node-red-contrib-valetudo Fun & Games Other Noteworthy Projects

Integrations

MQTT Home Assistant Node-RED openHAB

Misc

FAQ Style Guide Troubleshooting

Development

Building and Modifying Valetudo Valetudo core concepts MQTT