Setup with Dreamehome Account

This method should be used if the robot vacuum is currently managed via the Dreamehome application. To ensure compatibility, it can be verified against the official Dreamehome app available for iOS and Android.

Requirements

• Credentials: Must be the exact username and password used to log into the mobile application (not the official website).
• Account Type: Login via phone number is not supported; the account must be registered with an email address.
• Server Region: The selected country must match the region where the device is registered in the app. Mismatched regions will result in "login failed" or "device not found" errors.

Third-Party Logins

If the account was created using a third-party service (such as Google or Apple), a dedicated password must be generated within the application's user settings first. Third-party account passwords cannot be used for authentication.

Cloud Push Updates

This connection method utilizes Cloud Push for state updates while the device is idle, eliminating the need for continuous background polling. Periodic requests are only sent to the servers when the device is actively running (e.g., cleaning or returning to dock) to ensure real-time accuracy.

Re-authentication

The integration securely stores an authentication token after a successful login to communicate with the cloud servers. If this token expires or is invalidated by the cloud service for any reason, Home Assistant will automatically trigger a re-authentication flow, prompting for the account credentials to be entered again.