From 539182751927a2c524cd4f3660c4f23fe85eba69 Mon Sep 17 00:00:00 2001
From: Chewbaccalakis <nick@trochalakis.com>
Date: Fri, 19 Jun 2026 16:13:31 -0700
Subject: [PATCH] Add systemd service file and deployment instructions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md                  | 28 ++++++++++++++++++++++++++--
 audiopen-nextcloud.service | 14 ++++++++++++++
 2 files changed, 40 insertions(+), 2 deletions(-)
 create mode 100644 audiopen-nextcloud.service

diff --git a/README.md b/README.md
index 9990e3d..bbe774a 100644
--- a/README.md
+++ b/README.md
@@ -36,14 +36,38 @@ PORT=3000
 
 `ENCRYPTION_KEY` is required — the server will not start without it. `ADMIN_PASSWORD` is required to create new accounts via the web UI; without it, registration is disabled (existing users can still update their settings via their token URL).
 
-### 2. Run
+### 2. Install dependencies
 
 ```bash
 npm install
+```
+
+### 3. Run as a systemd service
+
+Copy the included service file and enable it:
+
+```bash
+sudo cp audiopen-nextcloud.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable --now audiopen-nextcloud
+```
+
+Check status or view logs:
+
+```bash
+sudo systemctl status audiopen-nextcloud
+sudo journalctl -u audiopen-nextcloud -f
+```
+
+The service expects the app to be installed at `/opt/audiopen-nextcloud` with a `.env` file in that directory.
+
+#### Running manually (without systemd)
+
+```bash
 node server.js
 ```
 
-### 3. Register users
+### 4. Register users
 
 Open `http://localhost:3000` in a browser. Each user fills in their Nextcloud credentials and the admin password, then receives:
 
diff --git a/audiopen-nextcloud.service b/audiopen-nextcloud.service
new file mode 100644
index 0000000..ec8c9f7
--- /dev/null
+++ b/audiopen-nextcloud.service
@@ -0,0 +1,14 @@
+[Unit]
+Description=AudioPen Nextcloud Webhook
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=/opt/audiopen-nextcloud
+ExecStart=/usr/bin/node server.js
+EnvironmentFile=/opt/audiopen-nextcloud/.env
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target