Deployment

Lean CMS is designed for single-server deployment using Kamal and SQLite. This combination keeps infrastructure simple and costs low — ideal for client marketing sites.

  • Kamal 2 — zero-downtime deploys, Docker-based, no cloud lock-in
  • SQLite — no separate database server, file-based backups, production-ready with WAL mode
  • GitHub Container Registry — free image hosting
  • Hetzner or DigitalOcean — $6–$12/month for a VPS that handles a marketing site comfortably
  • S3 — for file uploads (images) only; keeps them off the server alongside the database

Guides

  • Kamal Deployment — first deploy and ongoing workflow
  • Kamal Hooks — pre-deploy safety checks and post-deploy cache clearing
  • SQLite Production — WAL mode, backups, monitoring, and when to switch to Postgres
  • Content Sync — pull production data locally, edit, and push back safely

Table of contents