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

title, description, ha_category, ha_config_flow, ha_zeroconf, ha_release, ha_iot_class, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_quality_scale

title	description	ha_category	ha_config_flow	ha_zeroconf	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale
homee	Instructions on how to setup homee devices in Home Assistant.	Alarm Binary sensor Button Climate Cover Event Fan Light Lock Number Select Sensor Switch Valve	true	true	2025.2	Local Push	@Taraman17	homee	alarm_control_panel binary_sensor button climate cover diagnostics event fan light lock number select sensor siren switch valve	hub	silver

homee is a smart home system, able to integrate various protocols such as Z-Wave, Zigbee, EnOcean, and more. The homee {% term integration %} will let you use the {% term devices %} from your homee in Home Assistant.

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.

1. In your homee app, in the top-left corner, tap the menu button.
2. On the top right of the opening menu, tap the gear {% icon "mdi:gear-outline" %} icon.
3. Choose Manage users.
4. Choose Add user and configure the desired values.

{% include integrations/config_flow.md %}

{% configuration_basic %} Host: description: The IP Address of your homee. User: description: The username you chose in the Prerequisites. Password: description: The password for that user. {% endconfiguration_basic %}

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 {% term device %} works as expected in homee. If a homee device shows up in Home Assistant, but does not work as expected or is missing {% term entities %}, open a report and attach error logs and the device's {% term diagnostics %} data.

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 and attach error logs and the diagnostic data of the {% term integration %}.

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

1. Go to {% my integrations title="Settings > Devices & services" %} and select the homee integration card.
2. From the list of hubs, select the one you want to reconfigure.
3. Next to the entry, select the three dots {% icon "mdi:dots-vertical" %} 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.

{% include integrations/remove_device_service.md %}