Files
ulicraft-server-v1/plan/12-build-order.md
Oier Bravo Urtasun 67d1f82e6a refactor!: unify into one compose, drop airgap/mirror/dnsmasq/avahi/blessingskin
Collapse the override-file matrix into a single docker-compose.yml holding the
whole stack: drasl, minecraft, mc-backup, caddy, nmsr, uptime-kuma. Bring-up is
now just `docker compose up -d --build`.

Removed features (dead-ends for this deployment):
- airgap / full asset mirror (mirror-airgap.sh, mirror-mods.sh, 20-mirror.caddy,
  caddy local-CA export, /ca.crt)
- dnsmasq + avahi/mDNS + dns-records.sh + mdns-host-setup.sh + ENABLE_MDNS;
  DNS is now handled outside this repo (HOST_LAN_IP dropped)
- Blessing Skin auth variant (compose + 00-core-blessingskin.caddy + BS_* env)
- host-nginx-static variant (docker-compose.nginx.yml, nginx/ulicraft.conf.tmpl)
- build-stack.sh and its run modes (online/airgap/core)

Production ingress is the only path now: host nginx terminates TLS (LE certs)
in front of caddy on a localhost-only port; caddy routes every vhost by Host
header. Launcher downloads move mirror/launcher -> launcher/.

Docs: README, deploy skill, and plan/ rewritten to match; obsolete plan docs
(dnsmasq, blessing-skin, assets-mirror, full-airgap-mirror, dns-and-run-modes)
deleted.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-09 02:14:09 +02:00

2.6 KiB

Build order — one commit per task

Dependency-ordered. Each numbered item = one git commit. Operational steps (prep, acceptance test) need internet/hardware and are NOT commits — marked [ops].

Commit message convention: Conventional Commits, scope = service. Footer: Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>.

Phase 0 — baseline

  1. chore: baseline scaffolding — CLAUDE.md, plan/, docker-compose.yml, runtime/, .gitignore, .env.example.

Phase 1 — config foundation

  1. feat(env): add BASE_DOMAIN + RCON_PASSWORD + CADDY_* to .env.example
  2. feat(tooling): add render-config.sh (envsubst BASE_DOMAIN, halt on unset)

Phase 2 — ingress (caddy internal router)

  1. feat(caddy): add conf.d snippets (00-core auth+pack, 10-static apex+launcher)
  2. feat(compose): add caddy service (127.0.0.1:CADDY_HTTP_PORT) + network aliases

Phase 3 — auth

  1. feat(drasl): add config.toml.tmpl (password login, SignPublicKeys=false)
  2. refactor(compose): drasl internal-only behind caddy; authlib URL → auth.

Phase 4 — modpack

  1. feat(pack): packwiz init + initial mod curation
  2. feat(tooling): add render-pack.sh + add-custom-mod.sh
  3. refactor(compose): minecraft via PACKWIZ_URL

Phase 5 — landing

  1. feat(landing): Astro+TS onboarding site → www/
  2. chore(landing): wire logo + .gitignore for www/

Phase 6 — launcher distribution

  1. feat(tooling): add fetch-launcher.sh (all platforms + stable symlinks)

Phase 7 — extra services

  1. feat(avatar): add nmsr service (Drasl-backed) + 40-avatar.caddy
  2. feat(status): add uptime-kuma service + 50-status.caddy
  3. feat(distribution): add 30-distribution.caddy (static, another repo)

Phase 8 — backups

  1. feat(compose): add mc-backup service (RCON, 6h)

Phase 9 — production ingress / TLS

  1. feat(nginx): add ulicraft-caddy.conf.tmpl + render-nginx.sh
  2. feat(tls): add issue-letsencrypt.sh (OVH DNS-01) + LE env block

Phase 10 — operational (no commits)

  • [ops] Prep online (once): tooling/render-config.sh, build landing (cd landing && pnpm run build), tooling/fetch-launcher.sh, fetch authlib-injector into runtime/.
  • [ops] TLS: tooling/issue-letsencrypt.sh, then tooling/render-nginx.sh --install.
  • [ops] Bring up: docker compose up -d --build.
  • [ops] Acceptance: install Fjord, add drasl account, import pack, join.
  • [ops] If green: tag v1-ready.

Notes

  • Bring-up is a single command — no run modes, no override compose files.
  • Each commit should leave the tree in a non-broken state (compose still parses).