---
title: Connect to Home Assistant
slug: bar/smart-home/connect-home-assistant
description: Learn how to connect BUSY Bar to Home Assistant to control your device to use it in smart home automations
image: https://cdn.images.archbee.com/3StCFqarJkJQZV-7N79yY/_VjlIec24cwrxwFGUZ5Oa_busy-docs-preview.png
createdAt: 2026-11-05T13:34:01.592Z
---
Home Assistant is an open-source smart home platform that brings your connected devices together, letting you control them and create automations from one place. Connect BUSY Bar to Home Assistant to control it from your smart home and include it in your automations.
If you’re new to Home Assistant, first follow the official [Getting Started with Home Assistant](https://www.home-assistant.io/getting-started/) guide to learn the basics and get set up.
This guide explains how to connect and disconnect BUSY Bar, and what you can do with it in Home Assistant.
:::hint{type="info"}
**** **Coming soon\: BUSY Bar in Home Assistant’s built-in integrations******
We’re working on adding BUSY Bar to Home Assistant’s built-in integrations. In the meantime, you can install the official BUSY Bar integration using the instructions below.
:::
On this page:
- [How BUSY Bar connects to Home Assistant%section%](https://docs.busy.app/bar/smart-home/connect-home-assistant#how-busy-bar-connects-to-home-assistant)
- [Connect BUSY Bar to Home Assistant%section%](docId\:NPgBthGLUq36MnPhqEt1f)
- [BUSY Bar in Home Assistant%section%](docId\:NPgBthGLUq36MnPhqEt1f)
- [Disconnect from Home Assistant%section%](docId\:NPgBthGLUq36MnPhqEt1f)
***
# How BUSY Bar connects to Home Assistant
BUSY Bar connects to Home Assistant over your local Wi-Fi network. To enable the connection, [turn on Wi-Fi access](https://docs.busy.app/bar/dev/http-api#wi-fi-access) on BUSY Bar and set a password. You’ll need this password when connecting BUSY Bar to Home Assistant.
***
# Connect BUSY Bar to Home Assistant
Before continuing, make sure:
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/g3_A8N1h8KEjcfm-9lWoN_access-unlock.png" alt caption width="96" height="96"} [Wi-Fi access is enabled on BUSY Bar%page%](docId\:H4whpEXTNlYjSR9PlxsAr)
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/xw212B58huGnFADxWtLeO_firmware-update-icon.png" alt caption width="96" height="96"} [BUSY Bar runs firmware version 1.2.3 or later%page%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is on the same Wi-Fi network as Home Assistant%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/6OQKa5xLF7OemLvQnparM_ha-logo.png" alt caption width="96" height="96"} Home Assistant runs version 2026.1.0 or later. To check your version, go to **Settings → About** in Home Assistant
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/M4wXaoWLUMIDP7f5XW4na_github-logo.png" alt caption width="96" height="96"} You have a [GitHub](https://github.com/) account
Choose your Home Assistant version:
::::::Tabs
:::::Tab{title="Versions 2026.1 – 2026.10"}
## Step 1. Install HACS
HACS (Home Assistant Community Store) lets you download community-made integrations, plugins, and themes that aren’t included in Home Assistant by default.
Skip this step if you already have **HACS** and can see it in the Home Assistant left sidebar.
::::WorkflowBlock
:::WorkflowBlockItem
Download HACS from its [official website](https://www.hacs.xyz/docs/use/download/download/), choosing your preferred installation type.
:::
:::WorkflowBlockItem
Restart Home Assistant:
1. Go to **Settings -> System**.
2. Click the power icon in the top-right corner, then **Restart Home Assistant**.
:::
:::WorkflowBlockItem
Go to **Settings -> Devices & services -> Add integration**, click **HACS**, then follow the on-screen steps.
:::
:::WorkflowBlockItem
Sign in to GitHub when prompted.
:::
::::
## Step 2. Install the BUSY Bar integration
The official [BUSY Bar integration](https://github.com/busy-app/busy-hacs) connects BUSY Bar to Home Assistant over Wi-Fi, letting you control your device and use it in automations.
::::WorkflowBlock
:::WorkflowBlockItem
Open **HACS** from the left sidebar in Home Assistant.
:::
:::WorkflowBlockItem
In the top-right corner, click :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/HWhok535auK9ky0eShyuk_three-dots-icon-rotated.png" alt caption width="88" height="96"}, then **Custom repositories**.
:::
:::WorkflowBlockItem
In **Repository**, enter `https://github.com/busy-app/busy-hacs`
:::
:::WorkflowBlockItem
In **Type**, select **Integration**, then click **Add**. Close the window.
:::
:::WorkflowBlockItem
In HACS, search for the **BUSY Bar** integration.
:::
:::WorkflowBlockItem
Click **BUSY Bar**. In the bottom-right corner, click **Download**, then **Download** again to confirm.
:::
:::WorkflowBlockItem
Restart Home Assistant:
1. Go to **Settings -> System**.
2. Click the power icon in the top-right corner, then **Restart Home Assistant**.
:::
::::
## Step 3. Add your BUSY Bar to Home Assistant
::::WorkflowBlock
:::WorkflowBlockItem
In Home Assistant, go to **Settings -> Devices & services -> Add integration**.
:::
:::WorkflowBlockItem
Search for **BUSY Bar** and select it. Home Assistant starts looking for BUSY Bar devices on your network.
:::
:::WorkflowBlockItem
Select your BUSY Bar, then click **Submit**.
:::
:::WorkflowBlockItem
In the **Wi-Fi access key** field, enter your Wi-Fi access password.
*Forgot your Wi-Fi access password? See [how to reset it%page%](https://docs.busy.app/bar/troubleshooting/local-web-interface#forgot-password-when-accessing-the-web-interface-o)*
:::
:::WorkflowBlockItem
Choose an area (room) for BUSY Bar, then click **Finish**.
:::
::::
:::ExpandableHeading
*Home Assistant can’t find your BUSY Bar? Click here for help*:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
Make sure that:
- BUSY Bar is charged and turned on
- Wi-Fi access is enabled — for details, see [Wi-Fi access%page%](docId\:H4whpEXTNlYjSR9PlxsAr)
- BUSY Bar is on the same Wi-Fi network as Home Assistant
:::
:::::
:::::Tab{title="Versions 2026.11 or later"}
## Step 1. Install the BUSY Bar integration
The official [BUSY Bar integration](https://github.com/busy-app/busy-hacs) connects BUSY Bar to Home Assistant over Wi-Fi, letting you control your device and use it in automations.
::::WorkflowBlock
:::WorkflowBlockItem
In Home Assistant, go to **Settings -> Marketplace** and agree to the conditions.
:::
:::WorkflowBlockItem
In the top-right corner, click **Add from link**.
:::
:::WorkflowBlockItem
Enter `https://github.com/busy-app/busy-hacs`, then click **Add**.
:::
:::WorkflowBlockItem
If you haven’t connected GitHub yet, the Marketplace asks you to:
1. Click **Continue** and open the link.
2. Enter the code shown, and approve the connection on GitHub.
3. Go back to Home Assistant.
:::
:::WorkflowBlockItem
If the Marketplace asks for the **Type**, select **Integration**, then click **Add**.
:::
:::WorkflowBlockItem
Click **BUSY Bar** in the list, then click **Install**, then confirm.
:::
::::
## Step 2. Add your BUSY Bar to Home Assistant
::::WorkflowBlock
:::WorkflowBlockItem
In Home Assistant, go to **Settings -> Devices & services -> Add integration**.
:::
:::WorkflowBlockItem
Search for **BUSY Bar** and click it. Home Assistant starts looking for BUSY Bar devices on your network.
:::
:::WorkflowBlockItem
Select your BUSY Bar, then click **Submit**.
:::
:::WorkflowBlockItem
In the **Wi-Fi access key** field, enter your Wi-Fi access password.
*Forgot your Wi-Fi access password? See [how to reset it%page%](https://docs.busy.app/bar/troubleshooting/local-web-interface#forgot-password-when-accessing-the-web-interface-o)*
:::
:::WorkflowBlockItem
Choose an area (room) for BUSY Bar, then click **Finish**.
:::
::::
:::ExpandableHeading
*Home Assistant can’t find your BUSY Bar? Click here for help*:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
Make sure that:
- BUSY Bar is charged and turned on
- Wi-Fi access is enabled — for details, see [Wi-Fi access%page%](docId\:H4whpEXTNlYjSR9PlxsAr)
- BUSY Bar is on the same Wi-Fi network as Home Assistant
:::
:::::
::::::
:::hint{type="success"}
:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"} **Your BUSY Bar is now in Home Assistant**
Read on to learn what you can do with it.
:::
***
# BUSY Bar in Home Assistant
After connecting BUSY Bar, it appears as a device in Home Assistant. To open its device page, go to **Settings → Devices & services → Devices**, then select your BUSY Bar.
Here’s what you’ll find on the device page:
- **Device info** — View BUSY Bar’s firmware and hardware versions and serial number.
- **Controls** — Start, pause, and stop sessions, or change the switch position on BUSY Bar.
- **Sensors** — See what BUSY Bar is doing, including a live view of its screen.
- **Events** — Track button presses and wheel turns on BUSY Bar.
- **Configuration** — Adjust settings such as screen brightness and sound volume. You can also configure three additional session types (Interval, Simple, and Infinite) that exist only in Home Assistant and can only be started and controlled from there.
- **Diagnostic** — Check the battery level, Wi-Fi connection, and firmware details.
BUSY Bar also provides actions you can use in automations, such as **Show a notification**. Learn more: [Set up automations in Home Assistant%page%](docId\:KFsOPtK-JKtQylqaElMVP)
***
# Disconnect BUSY Bar from Home Assistant
After disconnecting, you won’t be able to control BUSY Bar from Home Assistant or use it in smart home automations. You can reconnect at any time by following [this guide](https://docs.busy.app/bar/smart-home/connect-home-assistant#connect-busy-bar-to-home-assistant) again.
## Option 1. Disconnect through Home Assistant
Make sure BUSY Bar is turned on and connected to Wi-Fi. Home Assistant needs to reach BUSY Bar to revoke its access token.
::::WorkflowBlock
:::WorkflowBlockItem
In Home Assistant, go to **Settings -> Devices & services**.
:::
:::WorkflowBlockItem
Under **Configured**, click the **BUSY Bar** integration.
:::
:::WorkflowBlockItem
Next to your BUSY Bar, click :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/HWhok535auK9ky0eShyuk_three-dots-icon-rotated.png" alt caption width="88" height="96"}, then **Delete**.
:::
:::WorkflowBlockItem
Click **Delete** again to confirm.
:::
::::
## Option 2. Disconnect through the BUSY Bar web interface
You can also disconnect Home Assistant from BUSY Bar’s web interface by deleting its access token. This revokes Home Assistant’s access without requiring you to open Home Assistant.
::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to your computer via USB.
:::
:::WorkflowBlockItem
Open [http://10.0.4.20](http://10.0.4.20) in a web browser.
:::
:::WorkflowBlockItem
On the **Settings** tab, under **Smart home**, click **Home Assistant**.
:::
:::WorkflowBlockItem
Click **Delete token**, then confirm.
:::
::::