Changeset 9465a0d in Klonkt for deploy

Timestamp:

06/16/2026 03:00:16 AM (3 months ago)

Author:

roboburr <roboburr@…>

Branches:

main

Children:

5019e22

Parents:

ff08153

Message:

Rename pm2 process prutcms -> klonkt (drop legacy name)

ecosystem.config.cjs name + DEPLOY.md. The post-receive hook + the running
pm2 process are handled separately server-side.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@…>

File:

• deploy/DEPLOY.md (modified) (8 diffs)

deploy/DEPLOY.md

@@ -56 +56 @@
 
 # As your user:
-mkdir -p ~/prutcms
-cd ~/prutcms
+mkdir -p ~/klonkt
+cd ~/klonkt
 # Clone or rsync your code here. e.g. via git:
 # git clone <your-repo> .
@@ -87 +87 @@
 
 # Optional: override storage paths
-# DATABASE_PATH=/home/robin/prutcms/storage/database.sqlite
-# AUDIO_PATH=/home/robin/prutcms/storage/audio
-# AVATAR_PATH=/home/robin/prutcms/storage/media/avatars
-# COVER_PATH=/home/robin/prutcms/storage/media/audio-covers
-# MEDIA_PATH=/home/robin/prutcms/storage/media
+# DATABASE_PATH=/home/robin/klonkt/storage/database.sqlite
+# AUDIO_PATH=/home/robin/klonkt/storage/audio
+# AVATAR_PATH=/home/robin/klonkt/storage/media/avatars
+# COVER_PATH=/home/robin/klonkt/storage/media/audio-covers
+# MEDIA_PATH=/home/robin/klonkt/storage/media
 ```
 
@@ -116 +116 @@
 ```bash
 curl -I http://127.0.0.1:3000/   # expect 200 / 302
-pm2 logs prutcms                 # live logs; Ctrl-C to detach
+pm2 logs klonkt                 # live logs; Ctrl-C to detach
 ```
 
@@ -128 +128 @@
 
 ```bash
-sudo cp deploy/nginx.conf.example /etc/nginx/sites-available/prutcms
-sudo $EDITOR /etc/nginx/sites-available/prutcms     # replace <YOUR-DOMAIN>
-sudo ln -s /etc/nginx/sites-available/prutcms /etc/nginx/sites-enabled/
+sudo cp deploy/nginx.conf.example /etc/nginx/sites-available/klonkt
+sudo $EDITOR /etc/nginx/sites-available/klonkt     # replace <YOUR-DOMAIN>
+sudo ln -s /etc/nginx/sites-available/klonkt /etc/nginx/sites-enabled/
 sudo rm -f /etc/nginx/sites-enabled/default
 sudo nginx -t
@@ -161 +161 @@
 ```bash
 chmod +x deploy/backup.sh
-mkdir -p ~/backups/prutcms ~/prutcms/logs
+mkdir -p ~/backups/klonkt ~/klonkt/logs
 
 # Test it once
@@ -168 +168 @@
 # Schedule nightly at 03:00
 ( crontab -l 2>/dev/null ; \
-  echo "0 3 * * * /home/$USER/prutcms/deploy/backup.sh >> /home/$USER/prutcms/logs/backup.log 2>&1" \
+  echo "0 3 * * * /home/$USER/klonkt/deploy/backup.sh >> /home/$USER/klonkt/logs/backup.log 2>&1" \
 ) | crontab -
 
@@ -181 +181 @@
 
 ```bash
-cd ~/prutcms
+cd ~/klonkt
 git pull
 npm ci --omit=dev
-pm2 reload prutcms     # zero-downtime within fork mode
+pm2 reload klonkt     # zero-downtime within fork mode
 ```
 
@@ -206 +206 @@
 | Symptom | Check |
 |---|---|
-| `❌ FATAL: SESSION_SECRET is required` | `.env` missing or unreadable. `pm2 stop prutcms && pm2 start ecosystem.config.cjs --env production`. |
+| `❌ FATAL: SESSION_SECRET is required` | `.env` missing or unreadable. `pm2 stop klonkt && pm2 start ecosystem.config.cjs --env production`. |
 | `❌ FATAL: SESSION_SECRET too weak for production` | Make it 32+ chars: `openssl rand -hex 32`. |
 | WS disconnects every minute | Check nginx `proxy_read_timeout` is ≥ 90s in `/ws/` block. |
 | Audio plays but seek stutters | nginx must have `proxy_buffering off` on `/audio/stream/`. |
-| 502 from nginx | `pm2 list` — is the app up? `pm2 logs prutcms --lines 100`. |
+| 502 from nginx | `pm2 list` — is the app up? `pm2 logs klonkt --lines 100`. |
 | HTMX 404s on `/assets/js/htmx.min.js` | `ls node_modules/htmx.org/dist/htmx.min.js` — if missing, `npm install htmx.org`. The boot-copy step needs the package. |