docs: improve Linux Service section in README

This commit is contained in:
Re-bin
2026-02-22 17:51:23 +00:00
parent 12af652d5a
commit 1aa06ea03d

View File

@@ -867,10 +867,15 @@ docker run -v ~/.nanobot:/root/.nanobot --rm nanobot status
## 🐧 Linux Service ## 🐧 Linux Service
Run the gateway as a systemd user service so it starts automatically and restarts on failure. Below example is for a Run the gateway as a systemd user service so it starts automatically and restarts on failure.
`pip` based installation.
**1. Create the service file** at `~/.config/systemd/user/nanobot-gateway.service`: **1. Find the nanobot binary path:**
```bash
which nanobot # e.g. /home/user/.local/bin/nanobot
```
**2. Create the service file** at `~/.config/systemd/user/nanobot-gateway.service` (replace `ExecStart` path if needed):
```ini ```ini
[Unit] [Unit]
@@ -890,27 +895,24 @@ ReadWritePaths=%h
WantedBy=default.target WantedBy=default.target
``` ```
**2. Enable and start:** **3. Enable and start:**
```bash ```bash
systemctl --user daemon-reload systemctl --user daemon-reload
systemctl --user enable --now nanobot-gateway systemctl --user enable --now nanobot-gateway
``` ```
**After config changes**, restart: **Common operations:**
```bash ```bash
systemctl --user restart nanobot-gateway systemctl --user status nanobot-gateway # check status
systemctl --user restart nanobot-gateway # restart after config changes
journalctl --user -u nanobot-gateway -f # follow logs
``` ```
If you modify the `.service` file itself, reload the unit before restarting: If you edit the `.service` file itself, run `systemctl --user daemon-reload` before restarting.
```bash > **Note:** User services only run while you are logged in. To keep the gateway running after logout, enable lingering:
systemctl --user daemon-reload
systemctl --user restart nanobot-gateway
```
> **Note:** By default, user services only run while you are logged in. To keep the gateway running after you log out, enable lingering:
> >
> ```bash > ```bash
> loginctl enable-linger $USER > loginctl enable-linger $USER