docs(install): clarify linger is required on headless systems (#299)

* docs(install): clarify linger is required on headless systems
This commit is contained in:
genericJE authored and GitHub committed 2026-04-20 03:02:36 +02:00
1 parent 4c9d92f499
commit 48d9868d1d
1 file changed
+8 -1
+8 -1
View File
@@ -24,7 +24,7 @@ Link the PipeWire configuration for ALSA applications:
sudo ln -s /usr/share/alsa/alsa.conf.d/50-pipewire.conf /etc/alsa/conf.d/
```
Allow services to run without an active user session (optional, for headless setups):
Allow services to run without an active user session. This step is **required on headless systems** (e.g. Raspberry Pi OS Lite), since PipeWire runs under the user's systemd session and only starts while someone is logged in. Without it, LVA will silently stop working after you close your SSH session.
```sh
sudo mkdir -p /var/lib/systemd/linger
@@ -33,6 +33,13 @@ sudo touch /var/lib/systemd/linger/$USER
💡 **Note:** Replace `$USER` with your actual username that you want to run the voice assistant.
You can verify it worked with:
```sh
loginctl show-user $USER | grep Linger
# Expected: Linger=yes
```
### Configure PipeWire (optional):
💡 **Note:** If you are not on a desktop system, which is already configured for PipeWire, you can configure it manually.