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 to Bluetooth devices, enabling interaction with and monitoring of connected peripherals. It is commonly used for diagnostics, tracking device presence, and managing local Bluetooth interactions.

Typical uses

  • Tracking Bluetooth device presence
  • Monitoring connection status
  • Troubleshooting Bluetooth issues
  • Controlling Bluetooth-enabled gadgets

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
276,251 (38.5 % 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.1.2

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

12 open issues and 7 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.10.0.

Open

  • open A warning about Docker permissions appears for Bluetooth adapters on Home Assistant OS. since December 6, 2025 · 8 reactions · 11 comments · #158132
  • open Bluetooth functionality stopped working after a recent update. since June 22, 2026 · 4 reactions · 25 comments · #174436
  • open Bluetooth integrations fail with local adapters if the OS Bluetooth stack crashes until a cold reboot. since July 22, 2025 · 3 reactions · 32 comments · #149228
  • open Bluetooth active scanning fails on Yellow+CM5 devices. Affects: Yellow+CM5 since November 24, 2025 · 2 reactions · 12 comments · #157211
  • open Bluetooth devices connected to a proxy become invisible to Home Assistant until power-cycled. since October 18, 2026 · 0 reactions · 9 comments · #187087
  • 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 issues occurred between core versions 2026.7.3 and 2026.10.3. since July 24, 2026 · 0 reactions · 5 comments · #177177
  • open USB Bluetooth adapters fail immediately after updating to version 18.3. Affects: USB Bluetooth adaptor since September 22, 2026 · 0 reactions · 4 comments · #182901

Fixed

  • fixed in 2026.10.0 A problem with composite source devices during Bluetooth scanner migrations was resolved. Fix #184568 · Issue #178087
  • fixed in 2026.6.1 Processing of Bluetooth advertisements during active scans was corrected. Fix #173116

Source: the issue tracker of Home Assistant, as of October 25, 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