# Roborock Local Server

> Self-hosted, open-source HTTPS and MQTT stack that replaces the Roborock cloud, keeping robot vacuums on an isolated LAN with live maps and no rooting.

- **Category:** Smart Home
- **Licence:** MIT
- **Latest version:** v1.2.1
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker Compose, Home Assistant
- **Tags:** WebRTC, Iot, Mqtt, HTTPS, Home Assistant, Local Control, Self Hosted, Smart Home, Robot vacuum, Reverse Engineering, Roborock Vacuum, Cloud Emulator, Vacuum Maps, Roborock

## Description

Roborock Local Server emulates the HTTPS and MQTT services a robot vacuum expects from its maker, so the device keeps its maps and controls on a network with no internet access. Nothing must be rooted, soldered or opened up, and a Wi-Fi reset on the robot puts it back into factory pairing mode. Getting there takes preparation: the hostname comes from a domain you own, must begin with api-, has to resolve to the machine's LAN address through local DNS you run yourself (your router, AdGuard Home or Pi-hole), and needs a trusted certificate that Cloudflare DNS-01 automation can issue and renew via ZeroSSL or Actalis, or that you supply as files. Run the published GHCR container image with Docker Compose on a Linux host, or register this repository in the Home Assistant Add-on Store and install the matching add-on; a setup wizard generates the configuration, and pairing happens afterwards from a second machine using the guided onboarding CLI or GUI, including for brand-new units never registered in the cloud. Everyday control comes from Home Assistant's Roborock integration, the open-source LocalRock phone app, or the stock Roborock app once MITM interception (plus a patched APK on Android) sends it your way; camera-equipped models can also push live video to a local WebRTC consumer through a built-in or external TURN relay. Documented limits: no firmware updates, no scheduled routines, the entry-level Q models are unsupported, and China-market units reject commands outside China.

## Links

- [Homepage](https://github.com/python-roborock/local_roborock_server)
- [Website](https://python-roborock.github.io/local_roborock_server/)
- [Docker](ghcr.io/python-roborock/local_roborock_server)
- [GitHub repository](https://github.com/Python-roborock/local_roborock_server)
- [Container package on GHCR](https://github.com/python-roborock/local_roborock_server/pkgs/container/local_roborock_server)
- [Tested vacuums list](https://python-roborock.github.io/local_roborock_server/tested_vacuums/)
- [Technical writeup](https://python-roborock.github.io/local_roborock_server/technical_writeup/)

---
Source: https://selfhost.directory/project/local-roborock-server