Run a Guardian Node

This page is the operator entrypoint for GuardianMesh hosts.

Start with the V1 Install Wizard for the website-first single-host flow.

Primary Flow (V1 Wizard)

Ubuntu 22.04+ single-host install for g1/g2/g3:

Multi-host orchestration is deferred to Phase 2.

Wizard supports web-to-shell handoff via downloadable guardianmesh-install.sh.

Quick Start (Docker)

cd deploy/guardian-node
cp .env.example .env
docker compose up -d --build

Adjust values in .env for your region, public endpoint, and limits.

Quick Start (Systemd, 3 Guardians)

./deploy/guardian-node/scripts/bootstrap-3-guardians.sh \
  guardianmesh.ca \
  deploy/guardian-node/generated \
  g1,g2,g3 \
  https://api.guardianmesh.ca \
  --base-port 9080 \
  --base-admin-port 9180

This generates configs, installs systemd units, restarts nodes, and verifies directory linkage.

Canonical Endpoints

• Run-node page: https://www.guardianmesh.ca/run-node.html
• Guardian websocket seeds: wss://g1.guardianmesh.ca/ws, wss://g2.guardianmesh.ca/ws, wss://g3.guardianmesh.ca/ws
• API: https://api.guardianmesh.ca
• Map: https://map.guardianmesh.ca

Node Publish Checklist

• Set GUARDIAN_PUBLIC_ENDPOINT to your reachable wss://... URL.
• Set a strong OPERATOR_TOKEN.
• Persist guardian-key.json and pending bundle store volume.
• Set GUARDIAN_DIRECTORY_URL=https://api.guardianmesh.ca for signed announce/heartbeat telemetry.

Live Network Snapshot