Skip to content

Commit

Permalink
Add Run with Systemd docs (#111)
Browse files Browse the repository at this point in the history
Co-authored-by: Cyberes <[email protected]>
  • Loading branch information
thomiceli and Cyberes committed Sep 25, 2023
1 parent 72275e7 commit fa8e068
Showing 1 changed file with 47 additions and 0 deletions.
47 changes: 47 additions & 0 deletions docs/administration/run-with-systemd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Run with Systemd

For non-Docker users, you could run Opengist as a systemd service.

On Unix distributions with systemd, place the Opengist binary like:

```shell
sudo cp opengist /usr/local/bin
sudo mkdir -p /var/lib/opengist
sudo cp config.yml /etc/opengist
```

Edit the Opengist home directory configuration in `/etc/opengist/config.yml` like:
```shell
opengist-home: /var/lib/opengist
```

Create a new user to run Opengist:
```shell
sudo useradd --system opengist
sudo mkdir -p /var/lib/opengist
sudo chown -R opengist:opengist /var/lib/opengist
```

Then create a service file at `/etc/systemd/system/opengist.service`:
```ini
[Unit]
Description=opengist Server
After=network.target

[Service]
Type=simple
User=opengist
Group=opengist
ExecStart=opengist --config /etc/opengist/config.yml
Restart=on-failure

[Install]
WantedBy=multi-user.target
```

Finally, start the service:
```shell
systemctl daemon-reload
systemctl enable --now opengist
systemctl status opengist
```

0 comments on commit fa8e068

Please sign in to comment.