From 9505958306c8a85413418769582fae55e017b5c2 Mon Sep 17 00:00:00 2001
From: callebtc <93376500+callebtc@users.noreply.github.com>
Date: Thu, 27 Jan 2022 21:07:47 +0100
Subject: [PATCH] systemd guide

---
 docs/guide/installation.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/guide/installation.md b/docs/guide/installation.md
index 47d369e4b..408813622 100644
--- a/docs/guide/installation.md
+++ b/docs/guide/installation.md
@@ -6,6 +6,7 @@ nav_order: 2
 
 # Basic installation
 Install Postgres and setup a database for LNbits:
+
 ```sh
 # on debian/ubuntu 'sudo apt-get -y install postgresql'
 # or follow instructions at https://www.postgresql.org/download/linux/
@@ -50,6 +51,7 @@ You might also need to install additional packages or perform additional setup s
 If you already have LNbits installed and running, on an SQLite database, we **HIGHLY** recommend you migrate to postgres!
 
 There's a script included that can do the migration easy. You should have Postgres already installed and there should be a password for the user, check the guide above.
+
 ```sh
 # STOP LNbits
 # on the LNBits folder, locate and edit 'conv.py' with the relevant credentials
@@ -67,6 +69,39 @@ Hopefully, everything works and get migrated... Launch LNbits again and check if
 
 # Additional guides
 
+### LNbits as a systemd service
+
+Systemd is great for taking care of your LNbits instance. It will start it on boot and restart it in case it crashes. If you want to run LNbits as a systemd service on your Debian/Ubuntu/Raspbian server, create a file at `/etc/systemd/system/lnbits.service` with the following content:
+
+```
+# Systemd unit for lnbits
+# /etc/systemd/system/lnbits.service
+
+[Unit]
+Description=LNbits
+#Wants=lnd.service # you can uncomment these lines if you know what you're doing
+#After=lnd.service # it will make sure that lnbits starts after lnd (replace with your own backend service)
+
+[Service]
+WorkingDirectory=/home/bitcoin/lnbits # replace with the absolute path of your lnbits installation
+ExecStart=/home/bitcoin/lnbits/venv/bin/uvicorn lnbits.__main__:app --port 5000 # same here
+User=bitcoin # replace with the user that you're running lnbits on
+Restart=always
+TimeoutSec=120
+RestartSec=30
+Environment=PYTHONUNBUFFERED=1 # this makes sure that you receive logs in real time
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Save the file and run the following commands:
+
+```sh
+sudo systemctl enable lnbits.service
+sudo systemctl start lnbits.service
+```
+
 ### LNbits running on Umbrel behind Tor
 
 If you want to run LNbits on your Umbrel but want it to be reached through clearnet, _Uxellodunum_ made an extensive [guide](https://community.getumbrel.com/t/guide-lnbits-without-tor/604) on how to do it.