Skip to content

docs: host on a VPS (production .env, first lab, HTTPS, backups); seed from the image - #27

Merged
BackStacked merged 1 commit into
mainfrom
claude/project-thread-t8n9ug
Nov 10, 2026
Merged

BackStacked merged 1 commit into
mainfrom
claude/project-thread-t8n9ug

Conversation

@BackStacked

Copy link
Copy Markdown
Contributor

Requested by Himanshu · project thread

  • docs/20-vps.md: one Ubuntu VPS with the released images: server hardening (ufw, SSH keys, Docker), files, the production .env, start, first lab, HTTPS with Caddy, daily pg_dump with off-server copies and a restore, updates, everyday commands, checklist.
  • deploy/production.env.example: only what production needs, CHANGE_ME where a value is required. HTTP_PORT=127.0.0.1:8080 (Docker's ports bypass ufw) and TRUST_PROXY=2 (Caddy + nginx).
  • dist/seed.js is now built (tsup entry), so the image can create the first lab: docker compose run --rm db-sync node dist/seed.js (direct to PostgreSQL; password taken from the shell's environment, never on the command line). Checked: node dist/sync.js then node dist/seed.js against PostgreSQL 17 created the org, branch, owner and 25 ledgers.
  • Links fixed: the update guide is docs/19-updates.md since feat: import partner-lab reports (report-reader) #23 took 18 (.env.example, compose header, release notes text).

docker compose --env-file deploy/production.env.example config binds nginx to 127.0.0.1:8080 and passes TRUST_PROXY=2.


Generated by Claude Code

…d from the image

- docs/20-vps.md and deploy/production.env.example
- dist/seed.js in the build, so `docker compose run --rm db-sync node dist/seed.js` creates the first lab
- links to the update guide point at docs/19-updates.md (renamed when #23 took 18)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018jBohmSXdQwAG8EmEBKYkQ
@BackStacked BackStacked self-assigned this Nov 10, 2026
@BackStacked
BackStacked merged commit 8581731 into main Nov 10, 2026
1 check passed
@BackStacked
BackStacked deleted the claude/project-thread-t8n9ug branch November 10, 2026 11:54
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.

2 participants