From 12b2485b7a60f881fba6ffba48e3b296eaa51930 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marek=20K=C3=BCthe?= <m.k@mk16.de>
Date: Sun, 8 Jan 2023 16:23:37 +0100
Subject: [PATCH] add docs how to create a systemd unit for babelweb2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Marek Küthe <m.k@mk16.de>
---
 docs/routing/babeld/babelweb2.md | 41 ++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/routing/babeld/babelweb2.md b/docs/routing/babeld/babelweb2.md
index f00d58e..e4748db 100644
--- a/docs/routing/babeld/babelweb2.md
+++ b/docs/routing/babeld/babelweb2.md
@@ -21,3 +21,44 @@ Now you have an executable program `babelweb2`.
 By default, the web interface runs on port 8080. You can also specify a different endpoint with the `-http` parameter.
 
 babelweb2 uses the local configuration interface of babeld. This must have been activated beforehand. babeld assumes that this is active on `[::1]:33123`. Alternatively, you can specify the endpoint with the `-node=` flag.
+
+
+## Install as Systemd Unit
+
+In order to install babelweb2 as a systemd unit, we must first install the necessary files into the system. For this we can execute the following commands in the babelweb2 git directory:
+```
+sudo cp babelweb2 /usr/local/bin
+sudo mkdir -p /usr/share/babelweb2/
+sudo cp -r ./static/ /usr/share/babelweb2/
+```
+
+After that we create the unit file `/etc/systemd/system/babelweb2.service`:
+```
+[Unit]
+Description=Yet Another Monitoring Tool for the Babel routing daemon
+Documentation=https://github.com/Vivena/babelweb2
+
+[Service]
+LimitNOFILE=1048576
+LimitNPROC=512
+User=nobody
+EnvironmentFile=/etc/default/babelweb2
+ExecStart=/usr/local/bin/babelweb2 -http $PORT -static $STATIC_DIR
+ExecReload=/bin/kill -SIGUSR1 $MAINPID
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+After that you can reload the units:
+```
+systemctl daemon-reload
+```
+
+For babelweb2 to work, we still need to specify the arguments. For this we can create an environment file `/etc/default/babelweb2`:
+```
+PORT=:<port>
+STATIC_DIR=/usr/share/babelweb2/static/
+```
+Here we replace `<port>` with the port on which the Babelweb2 interface should be available. The default is 8080, but you can also use 33124, for example.