From 5615f23b3d8a8f8a2618685be00e7edce68e031c Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Thu, 4 Aug 2022 01:58:25 -1000 Subject: [PATCH] Add section on BlueZ and getting the Dbus socket in the container to bluetooth (#23636) Co-authored-by: Franck Nijhof --- source/_integrations/bluetooth.markdown | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown index 515d8220317..bce9bcbb25b 100644 --- a/source/_integrations/bluetooth.markdown +++ b/source/_integrations/bluetooth.markdown @@ -35,6 +35,22 @@ For Bluetooth to function on Linux systems, the [D-Bus](https://en.wikipedia.org - 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. +### Additional details for Container installs + +{% details Making the DBus socket available in the Docker container %} + +For most systems, the Dbus socket is in `/run/dbus`. The socket must be available in the container for Home Assistant to be able to connect to Dbus and access the Bluetooth adapter. When starting with `docker run`, this can be accomplished by adding `-v /run/dbus:/run/dbus:ro` to the command. If the Dbus socket is in `/var/run/dbus` on the host system, use `-v /var/run/dbus:/run/dbus:ro` instead. + +{% enddetails %} + +### Additional details for Container and Supervised installs + +{% details Installing BlueZ %} + +On Debian based host systems, the `sudo apt-get -y install bluez` command will install BlueZ. + +{% enddetails %} + ## 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.