--- title: "Roborock" description: "Roborock is a built-in integration for Home Assistant. It has 55.7k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/roborock" url: "https://vulpo.app/integrations/core/roborock.md" last-updated: "2026-10-22" version: "1.4" --- # Roborock > Roborock is a built-in integration for Home Assistant. It has 55.7k installs sharing analytics and works locally. Roborock is a built-in Home Assistant integration that controls Roborock robot vacuums and mops locally. It adds vacuum entities along with buttons, selects, switches, numbers, times, sensors and binary sensors for settings such as cleaning mode, mop intensity, drying mode, volume and do not disturb hours. Buttons cover emptying the dustbin and resetting consumable counters, and sensors report status, errors, cleaning progress and filter time left. A map image is provided, and options choose what is drawn on it, such as room names, no-go zones, the path and obstacles. Actions can fetch maps, get the current position, send the vacuum to a position and clean a zone. Setup is done in the UI with an account email and a verification code, and devices can be discovered on the network. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=roborock) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Cleans up devices**: Devices that are gone are removed by themselves. - **Silver quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services. ### Connect - **Roborock server region**: The server region your Roborock account is registered in when setting up the app. Auto is recommended unless you are having issues. - **Email**: The email address used to sign in to the Roborock app. ### Enter the code - **Verification code**: The verification code sent to your email. ### Custom url - **Roborock Server URL**: The URL of the Roborock server. ### After setup - **Charger**: Show the charger on the map. - **Cleaned area**: Show the area cleaned on the map. - **Go-to path**: Show the go-to path on the map. - **Ignored obstacles**: Show ignored obstacles on the map. - **Ignored obstacles with photo**: Show ignored obstacles with photos on the map. - **Mop path**: Show the mop path on the map. - **No carpet zones**: Show the no carpet zones on the map. - **No-go zones**: Show the no-go zones on the map. - **No mopping zones**: Show the no-mop zones on the map. - **Obstacles**: Show obstacles on the map. - **Obstacles with photo**: Show obstacles with photos on the map. - **Path**: Show the path on the map. - **Predicted path**: Show the predicted path on the map. - **Room names**: Show room names on the map. - **Show background**: Add a background to the map. Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Clean water box, Cleaning fluid, Detergent, Dirty water box, Cleaning, Mop attached, Mop drying, Softener, Water box attached, Water shortage - **Buttons**: Empty dustbin, Pause, Reset air filter consumable, Reset cleaning brush consumable, Reset strainer consumable, Reset main brush consumable, Reset sensor consumable, Reset side brush consumable, Shut down, Start - **Images**: Map - **Numbers**: Volume - **Selects**: Cleaning mode, Cleaning route, Detergent type, Drying mode, Empty mode, Operating mode, Mop intensity, Mop mode, Wash program, Rinse times, Selected map, Softener type, and 3 more - **Sensors**: Error, Status, Roller left, Cleaning progress, Cleaning area, Maintenance brush time left, Cleaning time, Countdown, Current room, Dock error, Filter time used, Filter time left, and 18 more - **Switches**: Indicator light, Child lock, Do not disturb, Dust collection, Dust emptying, Mop drying, Mop washing, Off-peak charging, Sound setting, Status indicator light - **Times**: Do not disturb end, Do not disturb begin, Off-peak end, Off-peak start ## Actions - **Get maps**: Retrieves the map and room information of your device. - **Get current position**: Retrieves the current position of the vacuum. - **Go to position**: Sends the vacuum to a specific position. Fields: X-coordinate, Y-coordinate - **Clean zone**: Starts cleaning the specified zone. Fields: Repeats, X1-coordinate, X2-coordinate, Y1-coordinate, Y2-coordinate ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Cloud API used, The Roborock mop drying binary sensor is deprecated ## At a glance - Kind: Built-in integration - Category: [Appliances and cleaning](https://vulpo.app/integrations/category/appliances-and-cleaning.md), Cleaning - Brand: [Roborock](https://vulpo.app/integrations/roborock.md) - Number: 55.7k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Silver quality scale - Domain: `roborock` - Source: In Vulpo: Quick Toggle card, Robot Vacuum card (Pro), Button card, Select card, Apple Watch, Control Center, Vacuum Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for Roborock | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Roborock](https://github.com/humbertogontijo/homeassistant-roborock) | Marketplace integration | 825 installs sharing analytics | Works locally | Archived by its author | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/roborock --- - HTML version of this page: https://vulpo.app/integrations/core/roborock - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml