Back to the overview

Bluetooth in Home Assistant

bluetooth part of Home Assistant since 2022.8

Local, push Set up in the user interface Quality: Internal

The Bluetooth integration connects Home Assistant with Bluetooth-enabled devices, allowing interaction with smartphones, sensors, and other compatible hardware. It facilitates presence detection, device tracking, and control of Bluetooth-based accessories.

Typical uses

  • Track Bluetooth device presence
  • Control Bluetooth accessories
  • Monitor connected devices
  • Enable smartphone interactions

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Integration
Quality scale
Internal – Part of Home Assistant itself, not rated separately.
Installations
265,221 (38.8 % of the installations that share statistics)
Categories
Utility
Provides
Diagnostics
Maintained by
@bdraco
Python packages
bleak==3.0.2, bleak-retry-connector==4.7.1, bluetooth-adapters==2.4.0, bluetooth-auto-recovery==1.6.4, bluetooth-data-tools==1.29.24, dbus-fast==5.0.22, habluetooth==7.0.0

Setup

  1. In Home Assistant open Settings → Devices & services.
  2. Click "Add integration" and search for Bluetooth.
  3. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Known issues and fixes

11 open issues and 6 bug fixes in the last twelve months are recorded for Bluetooth in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.1.

Open

  • open A warning appears about Docker permissions when using a Bluetooth adapter on Home Assistant OS since December 6, 2025 · 8 reactions · 11 comments · #158132
  • open Bluetooth functionality has stopped working after a recent update since June 22, 2026 · 4 reactions · 23 comments · #174436
  • open Bluetooth integrations stop working if the OS-level Bluetooth stack crashes and require a cold reboot to resume since July 22, 2025 · 3 reactions · 32 comments · #149228
  • open Bluetooth active scanning fails on devices with Yellow+CM5 hardware Affects: Yellow+CM5 since November 24, 2025 · 2 reactions · 12 comments · #157211
  • open The Aqua precise device cannot be added to Gardena Bluetooth integration when using an internal USB connection since June 20, 2026 · 0 reactions · 18 comments · #174338
  • open Bluetooth hci0 power state timeouts occur on HA Yellow (CM4) after an upgrade Affects: HA Yellow (CM4) since August 17, 2026 · 0 reactions · 5 comments · #179356
  • open Bluetooth problems emerged in the 2026.7.3 version since July 24, 2026 · 0 reactions · 4 comments · #177177
  • open Passive BLE sensors do not update when signals are received through different proxies since August 23, 2026 · 0 reactions · 2 comments · #179913

Fixed

  • fixed in 2026.6.1 Active scans now correctly process Bluetooth advertisements Fix #173116
  • fixed in 2025.10.3 Bluetooth discovery now works for devices that alternate their advertisement names Fix #154347

Source: the issue tracker of Home Assistant, as of September 13, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.

Scroll to Top