---
name: "bluetooth-meshd"
section: "8"
platform: "linux"
package: "bluez-mesh"
version: "5.87-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/bluetooth-meshd"
---

# bluetooth-meshd(8)

Bluetooth Mesh daemon

## Name

bluetooth-meshd - Bluetooth Mesh daemon

## SYNOPSIS

**bluetooth-meshd** \[*options* ...\]

## DESCRIPTION

Daemon for managing Bluetooth Mesh connections on Linux.

## OPTIONS

- **-h, --help**

  Print bluetooth-meshd options and exit.

- **-n, --nodetach**

  Enable logging in foreground. Directs log output to the controlling terminal in addition to syslog.

- **-i** *\<type\>,* **--io** *\<type\>*

  Specifies I/O interface type:

  *auto* - Use first available controller: via MGMT interface if kernel supports it, otherwise, via raw HCI socket.

  *generic:\[hci\]\<index\>* - Use generic HCI io on interface hci\<index\>.

  *unit:\<fd\_path\>*- Specifies open file descriptor for daemon testing.

  By default, if no type is specified, uses auto I/O on the first available controller.

- **-c** *\<file\>,* **--config** *\<file\>*

  Specifies an explicit config file path instead of relying on the default path(*/etc/bluetooth/mesh-main.conf*) for the config file.

- **-s** *\<dir\_path\>,* **--storage** *\<dir***path\>**

  Specifies an explicit storage directory path instead of the default path(*/var/lib/bluetooth/mesh*) for storing mesh node(s) configuration.

- **-d, --debug**

  Enable debug output.

- **-b, --dbus-debug**

  Enable D-Bus debug output.

## FILES

- ***/etc/bluetooth/mesh-main.conf***

  Location of the global configuration file containing mesh daemon settings.

## RESOURCES

\<http://www.bluez.org\>

## REPORTING BUGS

\<linux-bluetooth@vger.kernel.org\>

## Copyright

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).
