Files
andon/docs/adr/0003-use-coolify-managed-postgres-over-sqlite.md
Julien Calixte 405b929f66 ci: Coolify autodeploy from main; migrate-on-boot and split dev/prod compose
- Add Nitro plugin to apply Drizzle migrations on server boot (skips when
  DATABASE_URL is unset, e.g. during build).
- Split compose: docker-compose.dev.yml (hot-reload + Postgres) vs
  docker-compose.yml (production/self-host, env-driven, Coolify-deployable).
- Add .dockerignore; parameterise compose env; document the autodeploy
  decision (Coolify watches main, no CI workflow needed) in ADR 0003 and
  plan.md T12.
2026-05-27 23:13:06 +02:00

1.2 KiB

Use Coolify-managed PostgreSQL over SQLite

The /deep-design session chose SQLite on a persistent volume for its zero-ops simplicity at this scale. Deploying on Coolify changes the calculus: Coolify provides managed PostgreSQL with automatic scheduled backups, whereas a SQLite file inside an app volume has no managed backup and forces a single-instance, stop-then-start deploy strategy to avoid file-lock contention when Coolify briefly runs old and new containers during a rolling restart. We switch to Coolify-managed PostgreSQL (via Drizzle's pg driver).

Consequences

  • Backups are handled by Coolify's database backup feature — no bespoke tooling (e.g. Litestream) needed.
  • Deploys no longer need a recreate/single-instance constraint; the app can restart freely while Postgres persists as a separate service.
  • Adds a Postgres service to local dev (docker-compose) and a managed DB in prod — one more moving part than a single file.
  • Supersedes the SQLite choice in DESIGN.md (T5, F10) and the original /deep-design decision.
  • Autodeploy from main is enabled (Coolify watches the repo and deploys on push); main must be protected with required PR review + CI so only vetted commits reach production.