mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 00:06:51 +00:00
Add notes about bluetooth requirements for each install type (#23510)
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
parent
e6987f4d14
commit
f10fc178ec
@ -25,6 +25,15 @@ While this integration is part of [`default_config:`](/integrations/default_conf
|
||||
bluetooth:
|
||||
```
|
||||
|
||||
## D-Bus and BlueZ are required on Linux
|
||||
|
||||
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.
|
||||
|
||||
- Home Assistant Operating System: no additional steps are required. Home Assistant OS version 8.4 or later is recommended for performance reasons.
|
||||
- Home Assistant Container: The host system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant **inside** the container.
|
||||
- Home Assistant Supervised: The host system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant **inside** the container.
|
||||
- Home Assistant Core: The system must run BlueZ, and the D-Bus socket must be accessible to Home Assistant.
|
||||
|
||||
## Installing a USB Bluetooth Adapter
|
||||
|
||||
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.
|
||||
|
Loading…
x
Reference in New Issue
Block a user