Skip to content

docs(landing): fix stale deploy runbook#58

Merged
huximaxi merged 2 commits into
mainfrom
docs/fix-deploy-runbook
May 26, 2026
Merged

docs(landing): fix stale deploy runbook#58
huximaxi merged 2 commits into
mainfrom
docs/fix-deploy-runbook

Conversation

@huximaxi
Copy link
Copy Markdown
Owner

Summary

landing/DEPLOY.md was stale and wrong in two ways that would mislead anyone deploying:

  • Path fiction: it described /var/www/loci.garden as the site root. That dir does not exist. Caddy's file_server actually serves the landing/ subdir of a git checkout, straight off disk.
  • Wrong command: it said git pull. The repo history was rewritten once (filter-repo scrub), so a long-lived VPS checkout has a forked history and will not fast-forward. The doc now documents fetch + reset --hard origin/main and explains why.

Also removed the index-old.html swap rollback in favour of a dir-copy backup (what's actually used), and kept host/path/credentials out of this public file per outgoing-quarantine discipline.

Test plan

  • Verified against the live Caddy config (root * .../landing) and the actual deploy performed this session
  • No server path / IP / SSH alias leaked into the public repo

huximaxi and others added 2 commits May 26, 2026 22:36
DEPLOY.md pointed at /var/www/loci.garden (does not exist) and said
`git pull`, which fails on the VPS checkout due to a rewritten history.
Corrects the served-root description (Caddy file_server off landing/),
documents fetch + reset --hard, and keeps operator specifics out of the
public repo.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@huximaxi huximaxi merged commit 308ab01 into main May 26, 2026
2 checks passed
@huximaxi huximaxi deleted the docs/fix-deploy-runbook branch May 26, 2026 21:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant