r00tpig/verae-keep
Watch
1
0
Fork
You've already forked verae-keep
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Host keep-alive: restart units unless admin paused or stopped them | Owner: Scott R00tPiG Security Lindsey (rootpig) — server maintenance & deployment.
1 commit 2 branches 0 tags 47 KiB
  • JavaScript 95.8%
  • Shell 4.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Scott "R00tPiG Security" Lindsey (r00tpig) d221bc8a69 Test env NATS cluster cut-over
2026-09-11 23:59:49 -04:00
scripts Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
src Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
systemd Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
test Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
NATS.md Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
package.json Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
README.md Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
SUMMARY.md Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
units.json Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
units.ns1.json Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00
units.px-worker.json Test env NATS cluster cut-over 2026-09-11 23:59:49 -04:00

README.md

verae-keep

Host keep-alive for Verae workers. Restarts a unit that crashed unless the operator console paused or stopped it.

Forgejo: https://git.georgelambert.org/marchon/verae-keep

Two processes:

Process Port Job
node src/keep.js :3860 Probe units, spawn if intent is run
node src/watch.js :3861 Restart keep if /health fails
scripts/guard.sh — Restart watch if watch exits

Intent is run | pause | stop. Sources, newest wins:

  1. POST /intent/:id (admin / API)
  2. ~/verae-fleet-runtime/data/<instance>/intent.json (fleet writes this on start/pause/stop)
  3. live FLEET_URL/api/status when set
  4. unit defaultIntent (run)

Pause: leave the process down or POST /pause. Stop: SIGTERM and do not spawn. Run: spawn if health fails.

NS1 (70.88.205.138)

KEEP_UNITS=$HOME/verae-keep/units.ns1.json KEEP_STATE=$HOME/verae-keep/data \
  nohup bash scripts/guard.sh >/tmp/verae-keep-guard.out 2>&1 &

Or user systemd (survives reboot; do not also nohup guard.sh):

bash scripts/install-systemd.sh
systemctl --user start verae-keep-guard

Proxmox guest extra copies: KEEP_UNITS=units.px-worker.json.

Units: NATS (observe only), job-poller, webhook-deliver, archive-aggregator, archive-worm ×3, tree-node ×3.

API

  • GET /health GET /status
  • POST /intent/:id {"state":"pause|stop|run"}
  • POST /reconcile