> For the complete documentation index, see [llms.txt](https://docs.ruuvi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ruuvi.com/ruuvi-gateway-firmware/examples/home-assistant.md).

# Home Assistant

The Ruuvi Gateway integration was introduced in Home Assistant 2023.2, see <https://www.home-assistant.io/integrations/ruuvi_gateway/>

## Setup

Install [Home Assistant OS 9.5](https://github.com/home-assistant/operating-system/releases/tag/9.5) or newer.

Configure Ruuvi Gateway to use [Polling mode](/ruuvi-gateway-firmware/examples/polling-mode.md) (configure a Bearer token for read-only access).

Adding Ruuvi Gateway to your Home Assistant instance can easily be done by simply clicking on this [link](https://my.home-assistant.io/redirect/config_flow_start?domain=ruuvi_gateway). After that, you'll see the following confirmation:

![](/files/JzR2q3vknfIQlTbe3o3g)

After you click the **OPEN LINK** button, you may be prompted to log in:

![](/files/bdRw5GIZUJSWzeIpjO3j)

Then you will see a confirmation to set up the Ruuvi Gateway in Home Assistant:

![](/files/vPItE3sHims49IQENG2I)

After that, you will need to enter the IP address of Ruvvi Gateway and the Bearer token specified when configuring the Gateway:

![](/files/4PypGRi3Sh2djroLJZas)

That's it, then you will see a confirmation that Ruuvi Gateway has been successfully added:

![](/files/T5XwvOW3gOt7kYWoUzu4)

After that, the **Integrations** tab will open, where you can find the Ruuvi Gateway and a set of sensors:

![](/files/GRKYmBfQcjdm89C0PVX5)

You can manually open the **Integrations** tab:

* In the sidebar click on **Settings**
* From the configuration menu select: **Devices & Services**

You will then need to configure the discovered sensors, select one of them and press the **CONFIGURE** button:

![](/files/FNHYaRRd2jiLpAltg9OQ)

Then press the **SUBMIT** button:

![](/files/YZY7O6ilNes62hxm2RuX)

Configure **Area** for the sensor and press the **FINISH** button:

![](/files/OIWvTHgcohXZFeY5dBQX)

After that, the configured sensor will appear on the **Overview** page:

![](/files/xPPjLgRbZBvTxxm6RhTr)

That's all.