master-zapier-plan-draft/packages/overview/10-docs-sync.md
George Lambert 7a5e25639e
Some checks are pending
offline / test (push) Waiting to run
Add Proxmox worker CT, off-box watch, backup, and tagged deploy.
NS1 is the Proxmox host. verae-proxmox creates LXC 510 (verae-px-worker
10.10.10.20 on vmbr1) with a private NATS proxy on 10.10.10.1:4222.
verae-uptime GET-watches public doors; verae-backup snapshots SQLite and
worm/tree data; verae-deploy does host-deps + checkout + npm ci.
Fleet overlays/ns1 are checked in (start.sh no longer rewrites JSON).
User systemd + linger for keep and fleet survive reboot.
2026-09-11 23:35:44 -04:00

1.8 KiB

Documentation sync (2026-09-11)

Validated against the module list in packages/ and Forgejo repos.

Current public doors

Door Bind Notes
Customer portal access-web :3021/portal/ Static + /portal/api → loopback edge
Customer API access-api :3022
S2S leaf access-leaf :3023 No billing subjects
Zapier access-zapier :3024 Only Zapier HTTPS
Staff plane access-staff :3025 After IAM
zappier-edge loopback :3000 (NS1 all-in-one :13000) Admin, Stripe, not a public portal
Operator console fleet :3850 on 0.0.0.0 Pause/stop honored by keep
Staff IAM :3028 Named users, roles, sessions
Keep :3860 + watch :3861 + guard.sh Restart unless paused/stopped

New modules since the last catalog pass

  • verae-staff-iam, verae-staff-session, verae-staff-ui
  • verae-keep
  • verae-bootstrap (clone + npm per server type; scripts/host-deps.sh installs OS/Node/NATS)
  • verae-uptime, verae-backup, verae-deploy, verae-proxmox (LXC 510 on NS1 vmbr1)

Move the catalog to another hostname

HTML and PDF catalog links are path-relative. Rsync site/ to a new document root (for example docs.verae-time.net) without rewriting files.

  • Procedure: CATALOG-HOST.md in zapier-docs-master
  • Optional absolute retarget: python3 scripts/rewrite-docs-host.py --site ./site --from https://zapier.georgelambert.org --to https://docs.verae-time.net
  • Host packages for a new box: bash packages/verae-bootstrap/scripts/host-deps.sh --type ns1-all-in-one

Still blocked (not closable here)

  • Live api.veraetime.net (MOCK_VERAE=false)
  • NATS nkeys/mTLS three-node cluster
  • Zapier Platform push