Skip to content

Commit f10fc17

Browse files
bdracofrenck
andauthored
Add notes about bluetooth requirements for each install type (home-assistant#23510)
Co-authored-by: Franck Nijhof <git@frenck.dev>
1 parent e6987f4 commit f10fc17

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

source/_integrations/bluetooth.markdown

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,15 @@ While this integration is part of [`default_config:`](/integrations/default_conf
2525
bluetooth:
2626
```
2727
28+
## D-Bus and BlueZ are required on Linux
29+
30+
For Bluetooth to function on Linux systems, the [D-Bus](https://en.wikipedia.org/wiki/D-Bus) socket must be accessible to Home Assistant. The Bluetooth adapter must be accessible to D-Bus and running [BlueZ](http://www.bluez.org/) >= 5.43.
31+
32+
- Home Assistant Operating System: no additional steps are required. Home Assistant OS version 8.4 or later is recommended for performance reasons.
33+
- Home Assistant Container: The host system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant **inside** the container.
34+
- Home Assistant Supervised: The host system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant **inside** the container.
35+
- Home Assistant Core: The system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant.
36+
2837
## Installing a USB Bluetooth Adapter
2938
3039
Some systems may not come with Bluetooth and require a USB adapter. Installing an adapter for the first time may require multiple restarts for the device to be fully recognized.

0 commit comments

Comments
 (0)