home-assistant.io/source/_integrations/roomba.markdown

title, description, logo, ha_category, ha_release, ha_codeowners

title	description	logo	ha_category	ha_release	ha_codeowners
iRobot Roomba	Instructions on how to integrate your Wi-Fi enabled Roomba within Home Assistant.	irobot_roomba.png	Vacuum	0.51	@pschmitt

The roomba integration allows you to control your iRobot Roomba vacuum.

This platform has been tested and is confirmed to be working with the iRobot Roomba 980 and 890 models, but should also work fine with any Wi-Fi enabled Roomba like the 690 or the 960.

Configuration

To add your Roomba vacuum to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
vacuum:
  - platform: roomba
    host: IP_ADDRESS_OR_HOSTNAME
    username: BLID
    password: PASSWORD

{% configuration %} host: description: The hostname or IP address of the Roomba. required: true type: string username: description: The username (BLID) for your device. required: true type: string password: description: The password for your device. required: true type: string name: description: The name of the vacuum. required: false type: string default: Roomba certificate: description: Path to your certificate store. required: false type: string default: /etc/ssl/certs/ca-certificates.crt continuous: description: Whether to operate in continuous mode. required: false type: boolean default: true delay: description: Custom connection delay (in seconds) for periodic mode required: false type: integer default: 1 {% endconfiguration %}

The Roomba's MQTT server only allows a single connection. Enabling continuous mode will force the App to connect via the cloud to your Roomba. More info here

Retrieving your credentials

Please refer to here or here to retrieve both the BLID (username) and the password.