diff --git a/Section-Keybase-(basic).md b/Section-Keybase-(basic).md index 90125a0..e7f02d9 100644 --- a/Section-Keybase-(basic).md +++ b/Section-Keybase-(basic).md @@ -8,4 +8,36 @@ # Your bot account MUST already have access to the provided team or subteam! Team="mykeybase.team" RemoteNickFormat="[{PROTOCOL}/{BRIDGE}] <{NICK}> " -``` \ No newline at end of file +``` + +## Headless server install + systemd + +If you run matterbridge as a service in systemd and want to use a bridge with keybase, be sure to run the service as the default user via *user.slice*, since keybase also runs its services in *user.slice*. + +### Example service + +Create a matterbridge.service -> `/usr/lib/systemd/user/` -> + +``` +[Unit] +Description=matterbridge +After=network.target + +[Service] +ExecStart=/path-to-your-executable/matterbridge +Restart=on-failure +RestartSec=10s + +[Install] +WantedBy=multi-user.target +``` + +*Start service* - `systemctl --user start matterbridge.service` + +*Stop service* - `systemctl --user stop matterbridge.service` + +*Check Status* - `systemctl --user status matterbridge.service` + +*Start at System Startup* - `systemctl --user enable matterbridge.service` + +**If you are using an SSH session, user services might shut down, use this to prevent:** `loginctl enable-linger` \ No newline at end of file