From 9b6829e7723a8b86bfe7b5a075458e29aab14078 Mon Sep 17 00:00:00 2001
From: Trammell Hudson <hudson@trmm.net>
Date: Wed, 3 Apr 2024 01:20:46 +0200
Subject: [PATCH] docs: README: use systemd to start saxi on the pi (#181)

This patch adds documentation for starting saxi as a systemd unit
on the Raspberry Pi so that it runs at boot time and will restart if
the process exits for some reason.

Signed-off-by: Trammell Hudson <hudson@trmm.net>
Co-authored-by: Jeremy Rose <nornagon@nornagon.net>
---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index 37851666..5be59898 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,30 @@ $ sudo apt-get install -y nodejs
 
 and then proceed as above :) If you connect to the raspberry pi over ssh, you might want to run the `saxi` server inside a tmux or screen session to have it stay running even if your ssh session disconnects.
 
+If you want `saxi` to run at boot on the Pi you can use a systemd unit file and enable the service:
+
+```bash
+sudo tee /lib/systemd/system/saxi.service <<EOF
+[Unit]
+Description=Saxi
+After=network.target
+
+[Service]
+ExecStart=saxi
+Restart=always
+User=pi
+
+[Install]
+WantedBy=multi-user.target
+EOF
+sudo systemctl enable saxi.service
+```
+
+To watch the logs while it is running, use:
+```bash
+journalctl -f -u saxi
+```
+
 #### Raspberry Pi Zero OTG
 
 ![Pi Zero on an AxiDraw with a Y-shaped USB cable](docs/pi-zero.jpg)