Roborock Local Server Docs

Use this page as the main docs hub for setup, onboarding, and follow-up guides.

Start Here

1. Read Installation for the shared requirements and network setup.
2. Choose an install method:
   • finish the Docker Compose steps in Installation
   • or use Home Assistant to install the stack as a Home Assistant add-on
3. Use Cloudflare setup if you want Cloudflare DNS-01 auto-renew for certificates.
4. Run Onboarding from a second machine after the server is running.
5. Use Updating when moving an existing install to a newer stable release.

Support This Project

If you want to support this project, next time you buy a Roborock, use one of my links that can be found on the Support This Project page!

Integrations And Reference

• Known limitations
• Home Assistant
• Using the Roborock App
• Updating
• Tested vacuums
• Reverse proxy
• Custom MQTT
• Custom certificate management
• Technical Writeup