How sternnick/edge-vps works
edge-vps is an operational baseline for provisioning and maintaining the public Pangolin edge host; it does not configure Pangolin itself. The main operator workflow runs the numbered enrollment, shipping, preparation, SSH-staging, and proof steps, with proof serving as the in-service gate. Supporting capabilities cover host measurement, maintenance and backup tools, host-specific configuration, declared state, and operational procedures such as rebuild, networking, and engine decisions. Relationships below follow the README; sampled source was limited to the host-literal checker, so unshown script internals are not inferred.
Main entry points: run-all.sh Run sequence · state-and-backup.md State and backup · 05_prove.sh Prove readiness · 03_prep.sh Prepare host
Components 27
Provisioning workflow
- Run sequence
scripts/run-all.sh - Enroll key
scripts/01_enroll-key.sh - Ship repository
scripts/02_ship.sh - Prepare host
scripts/03_prep.sh - Stage SSH
scripts/04_stage-sshd.sh - Prove readiness
scripts/05_prove.sh
Host configuration
- Host identity config
config/edge.env.example - Declared state
state/README.md - Engine choice
state/engine - Account names
state/accounts - State changes
state/changelog.md
Operations and safeguards
- Host detection
scripts/lib/detect.sh - Offsite backup
scripts/tools/offsite-backup.sh - Disk reclaim
scripts/tools/reclaim-disk.sh - Safe reboot
scripts/tools/reboot-safe.sh - Reboot preflight
scripts/tools/preflight-reboot.sh - KEX diagnosis
scripts/tools/pq-check.sh - Identity rule gate
scripts/tools/check_host_literals.py
Operational guidance
- Maintenance baseline
docs/procedure/baseline.md - Rebuild runbook
docs/procedure/rebuild-runbook.md - Public-edge implications
docs/procedure/pangolin-on-vps.md - IPv6 readiness
docs/procedure/ipv6.md - State and backup
docs/procedure/state-and-backup.md - Provider checklist
docs/procedure/provider-checklist.md - Engine decision
docs/procedure/docker-vs-podman.md - Repository rules
docs/procedure/rules.md
Other components
- Operator
Connections 13
- Operator → Run sequence: starts
README.md - Run sequence → Enroll key: runs numbered steps
README.md - Run sequence → Ship repository: runs numbered steps
README.md - Run sequence → Prepare host: runs numbered steps
README.md - Run sequence → Stage SSH: runs numbered steps
README.md - Run sequence → Prove readiness: runs numbered steps
README.md - Prove readiness → Operator: declares readiness
README.md - Identity rule gate → Repository rules: enforces
scripts/tools/check_host_literals.py - State and backup → Offsite backup: documents
- Rebuild runbook → Run sequence: documents workflow
README.md - Maintenance baseline → Prepare host: describes toggles
README.md - Engine decision → Engine choice: documents decision
README.md - State and backup → Declared state: describes recovery
README.md