mirror of
https://github.com/thomiceli/opengist.git
synced 2024-12-22 20:42:40 +00:00
Update run-with-systemd.md (#254)
Add documention how to use systemd without root access
This commit is contained in:
parent
2782ced03d
commit
e4bbd756f0
1 changed files with 45 additions and 0 deletions
|
@ -2,6 +2,7 @@
|
||||||
|
|
||||||
For non-Docker users, you could run Opengist as a systemd service.
|
For non-Docker users, you could run Opengist as a systemd service.
|
||||||
|
|
||||||
|
## As root
|
||||||
On Unix distributions with systemd, place the Opengist binary like:
|
On Unix distributions with systemd, place the Opengist binary like:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
|
@ -45,3 +46,47 @@ systemctl daemon-reload
|
||||||
systemctl enable --now opengist
|
systemctl enable --now opengist
|
||||||
systemctl status opengist
|
systemctl status opengist
|
||||||
```
|
```
|
||||||
|
|
||||||
|
----
|
||||||
|
|
||||||
|
## As a normal user
|
||||||
|
**NOTE: This was tested on Ubuntu 20.04 and newer. For other distros, please check the respective documentation**
|
||||||
|
|
||||||
|
#### For the purpose of this documentation, we will assume that:
|
||||||
|
- You've followed the instructions on how to run opengist [from source](https://github.com/thomiceli/opengist?tab=readme-ov-file#from-source)
|
||||||
|
- Your shell user is named `pastebin`
|
||||||
|
- All commands are being executed as the `pastebin` user
|
||||||
|
|
||||||
|
_If none of the above is true, then adapt the commands and paths to fit your needs._
|
||||||
|
|
||||||
|
Enable lingering for the user:
|
||||||
|
```shell
|
||||||
|
loginctl enable-linger
|
||||||
|
```
|
||||||
|
|
||||||
|
Create the user systemd folder:
|
||||||
|
```
|
||||||
|
mkdir -p /home/pastebin/.config/systemd/user
|
||||||
|
```
|
||||||
|
|
||||||
|
Then create a service file at `/home/pastebin/.config/systemd/user/opengist.service`:
|
||||||
|
```ini
|
||||||
|
[Unit]
|
||||||
|
Description=opengist Server
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
ExecStart=/home/pastebin/opengist/opengist --config /home/pastebin/opengist/config.yml
|
||||||
|
Restart=on-failure
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=default.target
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally, start the service:
|
||||||
|
```shell
|
||||||
|
systemctl --user daemon-reload
|
||||||
|
systemctl --user enable --now opengist
|
||||||
|
systemctl --user status opengist
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in a new issue