Installation

This project is a community-developed custom integration for Home Assistant and is not part of the built-in Core integrations. It must be installed separately. A running Home Assistant instance is required prior to proceeding.

Prerequisites

• Home Assistant Core 2023.12.0 or newer
• Minimum 2.5GB allocated RAM
• A compatible Dreame, MOVA, Xiaomi, Mijia, or TROUVER robot vacuum (see Supported Devices)
• Access to the device:
  • Cloud: A valid account for one of Dreamehome, Xiaomi Home, MOVAhome, or TROUVER apps
  • Local: IP address and token (only applicable for devices released before 2022 and configured with Xiaomi Home)

WARNING

Rendering the live map can consume a significant amount of memory, especially for large maps. This may cause Home Assistant to crash due to out of memory errors. Memory usage can be reduced by enabling the Low Resolution Map setting in the configuration options.

My Home Assistant Optional Recommended

The My Home Assistant integration is used throughout this documentation for easy navigation. It is enabled by default if your Home Assistant uses default_config:. If not, you must manually add my: to your configuration.yaml file to use the shortcut buttons provided in this guide.

Whenever you see a badge like the one below, you can click on it to directly access the corresponding interface in your Home Assistant instance where the actions described in that section are performed.

Example my button

Installation Methods

As a custom integration, the component must be downloaded and installed before it can be configured. Installation can be performed using one of the following methods:

Via HACS Recommended

Manually