Skip to main content

Vera — Docusaurus Build & Deploy Process

This site is built on Vera and deployed as static files to VM700. No Node.js runs on VM700.

Build​

cd /home/southville-forge/Southville-Forge-System/Sites/docsaurus-echohuman
npm run build
# Output: build/

Deploy (from Proxmox host as relay)​

# Step 1 — pull build from Vera to Proxmox
rsync -avz --delete [email protected]:'/home/southville-forge/Southville-Forge-System/Sites/docsaurus-echohuman/build/' /tmp/docsaurus-build/

# Step 2 — push from Proxmox to VM700
rsync -avz --delete /tmp/docsaurus-build/ [email protected]:/opt/stacks/echohuman-docsaurus/site-build/

No container restart needed — nginx picks up new static files immediately.

Verify​

curl -I https://docsaurus.echohuman.org
curl -s https://docsaurus.echohuman.org | head -5

Adding Content​

  1. Create or edit .md files in docs/ subdirectories on Vera
  2. If adding a new page, add its id to sidebars.js
  3. Run npm run build
  4. Run the two rsync commands above

See Add Documentation runbook for step-by-step.