George Lambert
69e28af4d8
Some checks are pending
offline / test (push) Waiting to run
LXC 511–513 (nats-a/b/c on 10.10.10.21–23, vmbr1 only) form cluster verae with replicas=3. Host loopback 127.0.0.1:4222 is unchanged.
39 lines
1.9 KiB
Markdown
39 lines
1.9 KiB
Markdown
# 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`)
|
||
- `verae-nats-cluster` (LXC 511–513 JetStream on `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](https://git.georgelambert.org/marchon/zapier-docs-master/src/branch/main/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`
|