bleh/dist/INSTALL.md

bleh / blehd install notes

Recommended model

• bleh is unprivileged.
• blehd runs as root (recommended). It owns the BLE device, and exposes a Unix socket for bleh to use.
• Access to that socket can be restricted with --group (recommended).

Build

make build

Install (system)

sudo make install PREFIX=/usr/local

By default (SETCAP=auto), make install will apply capabilities to blehd when run as root.

If you plan to run blehd as a root system service (recommended), you can skip capabilities:

sudo make install SETCAP=0

Group access (optional)

If you want group-based access to the socket:

sudo groupadd -r bleh || true
sudo usermod -aG bleh $USER
# then re-login

Then run blehd with --group bleh.

systemd service (recommended)

Install the unit:

sudo make install-systemd

Enable it:

sudo systemctl daemon-reload
sudo systemctl enable --now blehd.service

This will run blehd as root, listening on:

• /run/bleh/blehd.sock

To uninstall:

sudo make uninstall-systemd

OpenRC service

Install the init script:

sudo make install-openrc

Enable it:

sudo rc-update add blehd default
sudo rc-service blehd start

To uninstall:

sudo make uninstall-openrc