From 918ed85280c0631abaaa079cc74e341b5ea8c089 Mon Sep 17 00:00:00 2001
From: clover caruso <git@paperclover.net>
Date: Thu, 11 Jun 2026 00:56:31 -0700
Subject: [PATCH] docs: uptime-kuma status page on the web node

closes #20

status.paperclover.net -> web node (5.78.97.105, explicit dns record
overriding the wildcard that points home), uptime-kuma 2.4.0 under pm2
on 127.0.0.1:3001, public status page with monitors for git/auth/
jelly/music/file/at/db/dawarich/speedtest. caddy vhost hot-loaded via
the admin api; persisting it into /etc/caddy/Caddyfile needs the sudo
one-liner in webnode-status.md.
---
 webnode-status.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 webnode-status.md

diff --git a/webnode-status.md b/webnode-status.md
new file mode 100644
index 0000000000000000000000000000000000000000..0227f09acb48fde331c0888a75a91c072455eed3
--- /dev/null
+++ b/webnode-status.md
@@ -0,0 +1,45 @@
+# status.paperclover.net (uptime-kuma on the web node)
+
+lives on the web node (`ssh paperclover.net`, usw-server-1) — NOT the nas —
+so the status page stays up when home goes down. (issue #20)
+
+## what's where
+
+| thing | location |
+|-------|----------|
+| uptime-kuma 2.4.0 checkout | `~/uptime-kuma` (git, release tag) |
+| data (sqlite, logs) | `~/uptime-kuma-data` |
+| process manager | pm2 app `uptime-kuma` (`pm2 logs uptime-kuma`), listens 127.0.0.1:3001 |
+| admin login | user `clo`, password in `~/kuma-admin-pass.txt` on the node — log in and change it |
+| dns | explicit A record `status` → 5.78.97.105 (overrides the `*` wildcard that points home; ddns-updater only touches the wildcard) |
+| public page | https://status.paperclover.net (status page slug `home`, entry page) |
+
+monitors: clover's git, snow sign on, jellyfin, navidrome, copyparty,
+at-proto pds, paperclover.net's database, dawarich, openspeedtest — all
+checked over public https every 60s from the web node.
+
+## caddy
+
+the vhost was hot-loaded via the admin api and is NOT yet in /etc/caddy/Caddyfile
+(that needs sudo). to persist it across caddy restarts, run on the web node:
+
+```sh
+sudo tee -a /etc/caddy/Caddyfile <<'EOF'
+
+status.paperclover.net {
+  reverse_proxy localhost:3001
+}
+EOF
+sudo systemctl reload caddy
+```
+
+(the same block is staged in `~/Caddyfile.new`, which is the live config.)
+
+## upgrading kuma
+
+```sh
+cd ~/uptime-kuma
+git fetch --depth 1 origin tag <ver> && git checkout <ver>
+npm ci --omit dev --no-audit && npm run download-dist
+pm2 restart uptime-kuma
+```
-- 
2.54.0