Homee
Homee
Prerequisites
You need to create a new user in your Homee app. Create a user that is only used by Home Assistant. For security reasons, it’s recommended to:
- Use a strong, unique password.
- Restrict the user’s permissions for what you want to do from Home Assistant.
- Do not use this account for any other purpose.
- In your Homee app, in the top-left corner, tap the menu button.
- On the top right of the opening menu, tap the gear
icon. - Choose Manage users.
- Choose Add user and configure the desired values.
Configuration
To add the Homee hub to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Homee.
-
Follow the instructions on screen to complete the setup.
Available devices will automatically show up in your Home Assistant installation. New devices added to Homee will be automatically discovered after a restart of Home Assistant. This restart is only required when adding new devices, not for state updates of existing devices.
Limitations
Changed values are reported from Homee in defined time intervals and not always in realtime. For example, while a cover moves, the position is updated only every few seconds and intermediate states may be missed by Home Assistant.
Troubleshooting
First, see the general Home Assistant troubleshooting guide.
The homee integration supports debug logs and diagnostics.
Homee device not working as expected
Make sure, the deviceA device is a model representing a physical or logical unit that contains entities. works as expected in homee.
If a homee device shows up in Home Assistant, but does not work as expected or is missing entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more], open a report
Integration not loading or homee device not showing up in HA
Check that the homee-user, used for Home Assistant, is allowed to see the device.
If that is the case, open a report
Reconfiguration
This integration supports reconfiguration, allowing you to change the IP address, even after a device has already been set up.
To start the reconfiguration
- Go to Settings > Devices & services and select the homee integration card.
- From the list of hubs, select the one you want to reconfigure.
- Next to the entry, select the three dots
menu. Then, select Reconfigure.
Removing the integration
This integration follows standard integration removal, and once the integration is removed, you can also remove the dedicated user from your Homee.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three dots
menu. Then, select Delete.