master-zapier-plan-draft/packages/verae-bootstrap
George Lambert 2d51d7a0dd
Some checks are pending
offline / test (push) Waiting to run
Document catalog host moves and add per-module host-deps installer.
zapier-docs-master now has CATALOG-HOST.md (relative PDFs / rewrite-docs-host.py)
and HOST-DEPS.md. verae-bootstrap/scripts/host-deps.sh checks and installs
git, Node, native build tools, and nats-server on Debian or Alpine from
host-deps.tsv (every Forgejo module). fetch.sh runs it before clone/npm.
2026-09-11 23:12:25 -04:00
..
scripts Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
types Put zapier.georgelambert.org service names on Caddy. 2026-09-11 20:04:57 -04:00
HOST-DEPS.md Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
host-deps.tsv Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
NATS.md Sync docs, add verae-bootstrap, and run the full stack on NS1. 2026-09-11 19:52:54 -04:00
package.json Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
README.md Document catalog host moves and add per-module host-deps installer. 2026-09-11 23:12:25 -04:00
repos.txt Sync docs, add verae-bootstrap, and run the full stack on NS1. 2026-09-11 19:52:54 -04:00
SUMMARY.md Sync docs, add verae-bootstrap, and run the full stack on NS1. 2026-09-11 19:52:54 -04:00

verae-bootstrap

Clone every Verae Time × Zapier module repo from Forgejo and install Node dependencies. Each server type has its own directory under types/ (repos list + README + start notes).

Forgejo: https://git.georgelambert.org/marchon/verae-bootstrap
SSH: ssh://git@git.georgelambert.org:2223/marchon/verae-bootstrap.git

Host requirements

scripts/host-deps.sh checks this machine and installs anything missing (Debian/Ubuntu apt, Alpine apk, Node tarball, nats-server release). Table: HOST-DEPS.md. Manifest: host-deps.tsv.

bash scripts/host-deps.sh --check --type ns1-all-in-one
bash scripts/host-deps.sh --type ns1-all-in-one    # install
Need Why
Node 20+ (node, npm); middleware wants 22 All HTTP and worker processes
Git + SSH to Forgejo port 2223 git clone ssh://git@git.georgelambert.org:2223/marchon/<name>.git
python3 make g++ Native addon better-sqlite3 on zappier-edge (rebuild on Linux)
nats-server -js on 127.0.0.1:4222 Archive / all-in-one types only — never a public bind
curl Health probes

Alpine first line if bash is missing: apk add --no-cache bash git curl. Zapier cloud never talks to NATS. Do not publish :4222.

Fetch

git clone ssh://git@git.georgelambert.org:2223/marchon/verae-bootstrap.git
cd verae-bootstrap
export VERAE_SRC=$HOME/verae-src
bash scripts/fetch.sh                 # every repo
bash scripts/fetch.sh ns1-all-in-one  # one server type

scripts/fetch.sh runs host-deps.sh (OS + Node), then clone.sh (main), then install-deps.sh (npm install on the target OS, then npm rebuild). Do not copy node_modules from macOS onto Linux — native addons such as better-sqlite3 will fail with invalid ELF header.

Server types

Type Directory What that host runs
ns1-all-in-one types/ns1-all-in-one/ Control plane + archive workers + keep (NS1 / 70.88.205.138)
control-plane types/control-plane/ Fleet, edges, IAM, billing HTTP (no worm/tree floor)
ns1-archive types/ns1-archive/ NATS + worm ×3 + tree-node ×3 + poller + webhook + aggregator + keep
lan-worker types/lan-worker/ Extra SSH worker (tree-node, archive-worm). Keep disabled until SSH works (lan-134).

Each type has repos.txt (subset of the master list) and README.md.

NS1 all-in-one notes

:3000 on 70.88.205.138 is already a public app. zappier-edge on that box binds 127.0.0.1:13000. Public portal remains access-web :3021/portal/. Archive workers are owned by verae-keep; fleet does not double-spawn them.