Skip to content



You can install the integration in two different ways:

Hacs (Preferred)

  1. Install HACS
  2. In HACS: Go to Integrations and search and install Deebot 4 Home Assistant
  3. Restart Home Assistant


  1. Go to the integration releases
  2. Download and extract into the folder custom_components of your Home Assistant instance.
  3. Restart Home Assistant


If possible please use the installation via Hacs, as Hacs will inform you when a new release is available.


  1. Open your Home Assistant instance and start setting up a new integration.

    Click on the button above or go to HA Settings -> Integration -> Add -> Deebot 4 Home Assistant.

  2. Configure

    • Country: Iso two-letter code. A list can be found here.
    • Continent: Iso two-letter code. If your continent code is not working, please fallback to ww.


There are some issues during the password encoding. Using some special characters (e.g., -) in your password does not work.

Chinese server configuration

For chinese server username you require "short id" and password. Short id look like "EXXXXXX". Don't use your mobile phone number, it won't work.

Since these servers are in China and unless you are close to China, don't expect very fast response.