Kamal Handbook
Kamal Handbook is the missing manual for the new Kamal deploy tool which lets you run Docker in production with minimal effort.
- — Visualize Kamal's concepts and learn things behind-the-scenes.
- — Understand Kamal's configuration.
- — Deploy practical life examples with confidence.
Kamal contributor and Lead Programmer at 37signals.
Chapters
Philosophy, components, and terminology.
How do deployments happen in Kamal?
Kamal expectations.
Run as a gem or Docker container.
Let's deploy something.
Dive in on roles and other configurations.
Environment and secrets.
Traefik routers and configuration.
Splitting staging from production.
Kamal and Docker volumes.
Learn about asset bridging.
Ship databases and micro-services.
Configure log drivers.
Run maintenance tasks.
Production single and multi-server Kamal setup.
What to do when things go wrong.
Automatic deployment with GitHub Actions.
Schedule tasks with cron.
Creating and restoring backups.
What we learned and what's next.
The one-page preview
Testimonials
❝ Finally bought it! Have learned more in 15 minutes than I did previously in hours.
Michael Koper, Twitter
❝ I love it, and it offers an additional depth and layer to the docs.
Mikael Henriksson, Twitter
❝ I just finished reading the first 50 pages. It's awesome and can’t wait to read the rest.
Lucas, Gumroad
FAQ
Is this book just for Rails?
Kamal is framework-independent and so I wrote the book in a general way, only mentioning assumptions about one's Dockerfile. Bring your Dockerfile and you are good.
Is this only for Ubuntu?
Kamal doesn't tie itself with any particular Linux flavor so you can use your favourite. The small provisioning examples in the book are tested against Ubuntu 22 LTS.