Valetudo aims to be a vendor-agnostic abstraction and cloud replacement for vacuum robots which started as a standalone binary on rooted roborock vacuums.

View the Project on GitHub Hypfer/Valetudo


Newcomer Guide Early 2021 Supported Robots Capabilities Overview Rooting instructions Upgrading


Roborock OTA Viomi

Companion Apps

Valeronoi Lovelace Valetudo Map Card I can't believe it's not Valetudo node-red-contrib-valetudo Fun & Games Other Noteworthy Projects


MQTT Home Assistant Node-RED openHAB


FAQ Frequently requested features Roborock, Files to backup Troubleshooting


Building and Modifying Valetudo Valetudo core concepts MQTT

Knowledge Base

Supported Roborock Devices Supported Viomi Devices Supported Dreame Devices


Free your vacuum from the cloud

Valetudo is a standalone binary which runs on rooted Vacuums of the Xiaomi ecosystem and aims to enable the user to operate the robot vacuum without any Cloud Connection whatsoever.

These are the Valetudo Docs. Simply use the navigation menu on the left to find what you’re looking for.

If you’re missing something or you’ve found something wrong or outdated, feel free to edit the page and open a PR. You can also add new pages if you want to document something that isn’t documented yet.

Also, make sure to check out the companion apps section.

Join the Discussion

Expectation Management

Please note that Valetudo is a hobby project built by some random person on the internet for their own use, which decided to distribute it for free and provide the source code as well, so that everyone could extend the software to their own liking.

There’s no money involved nor do I care about the size of my userbase.

This fact has a few implications:

With that out of the way, I’m of course always open to suggestions/ideas as long as they are well thought-out.

Thank you for using Valetudo :)