Custom Home Assistant integration for the Cecotec Conga 4690 robot vacuum.
This integration connects to the Cecotec/3irobotix cloud used by the official mobile app and exposes the robot in Home Assistant as a vacuum entity with useful controls and sensors.
This project is an independent community integration. It is not affiliated with, endorsed by, sponsored by or supported by Cecotec.
- Vacuum entity with start, pause, stop and return-to-base controls.
- Fan speed control from the vacuum entity.
- Water level control for mopping mode.
- Cleaning plan start buttons.
- Connection, battery, cleaning time, cleaned area, map name, house name and current room sensors.
- Spanish, English and Catalan translations.
- UI setup through Home Assistant config flow.
- Open HACS in Home Assistant.
- Go to Integrations.
- Open the three-dot menu and choose Custom repositories.
- Add this repository URL.
- Select Integration as the category.
- Install Cecotec Conga 4690.
- Restart Home Assistant.
- Add the integration from Settings > Devices & services.
Copy the custom_components/cecotec_conga folder into your Home Assistant custom_components directory:
config/custom_components/cecotec_conga
Restart Home Assistant, then add the integration from Settings > Devices & services.
The integration asks for the same account credentials used by the Cecotec mobile app.
The cloud service may allow only one active session at a time. If the mobile app is opened, Home Assistant can be logged out temporarily; the integration retries login automatically when needed.
The tools folder includes optional SSH utilities for the robot. They do not contain a fixed IP address or password and are not required for the Home Assistant integration to work.
Some Conga robots keep the local Linux system running but lose the cloud connection used by the official app and this integration. The watchdog is a small script installed on the robot that checks that cloud connection and reboots the robot only after repeated failures.
The watchdog avoids rebooting the robot while it is actively cleaning.
- Find your robot IP address in your router device list. It will usually look like
192.168.1.xxx. - Download this repository and unzip it.
- Open the
toolsfolder. - Double-click
install_watchdog_windows.bat. - Enter the robot IP address when asked.
- Enter the SSH user. Press Enter to use the default user,
root. - Enter the SSH password. Try the passwords listed below for your model.
- Wait until the script says
Watchdog installed.
The Windows launcher uses Python if it is already installed. If the Python dependency paramiko is missing, the script tries to install it automatically.
To remove the watchdog later, double-click remove_watchdog_windows.bat and enter the same IP, user, and password.
Install the watchdog:
python tools/install_watchdog.py --host 192.168.1.75Remove the watchdog:
python tools/remove_watchdog.py --host 192.168.1.75These are known default passwords used by Conga/3irobotix robots. Your robot must already have SSH enabled.
| Models | User | Password |
|---|---|---|
| Conga 3090 | root |
3irobotics |
| Conga 3x90, 4090, 4690, 5490 family | root |
@3I#sc$RD%xm^2S& |
Source for the documented defaults: https://congatudo.cloud/installation/robot-setup/
If neither password works, the robot may have a custom password, SSH may not be enabled, or the IP address may belong to a different device.
- Room cleaning buttons are intentionally not exposed in this release because the cloud API behavior is not reliable enough yet.
- Map rendering is not included in this release.
- This integration has been tested with a Cecotec Conga 4690.
This project is developed and maintained in personal time. If it helps you, you can support future development here:
Contributions help cover development tools, testing resources and maintenance costs.
MIT License. See LICENSE.md.