Kamal Handbook
2nd edition
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.
Now in second edition for Kamal 2.
Get your answers
" I can't recommend Kamal Handbook enough! I had so many unanswered questions after reading the Kamal documentation, and the handbook pretty much answered them all. Great book, great code examples and great explanation of every aspect of Kamal.
Peter Brinck, from Product Hunt launch
Chapters
Kamal contributor and Lead Programmer at 37signals.
Philosophy, components, and terminology.
How do deployments happen in Kamal?
Kamal expectations.
Run as a gem or Docker container.
Let's deploy something.
Basic server provisioning for Kamal.
Dive in on roles and other configurations.
Environment and secrets.
Proxy details and configuration.
Splitting staging from production.
Kamal and Docker volumes.
Learn about asset bridging.
Application and accessory healthchecks.
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
❝ As a developer who recently migrated from Heroku, I found the Kamal Handbook to be a game-changer. This book dives deep into the Kamal tool, providing a detailed and practical guide that's perfect for real-world applications. The explanations are clear, making complex topics accessible even to those new to the tool. Every page of this book reflects a deep understanding of what developers face daily and provides solutions that work.
David Paluy, from Product Hunt launch
❝ There is no way that I would have been able to implement Kamal as quickly as I did without the Kamal Handbook. Josef has taken the time to dive deeply into the inner workings of Kamal, and has distilled the topic into a straightforward document. Your time is valuable. Buy this handbook. You will thank yourself later."
David Lewis, from Gumroad
❝ Well spent money. I needed to get quickly up to speed with Kamal, without having to deal with the docs or tutorials. Great introduction, hints, and suggestions. If you're starting your journey with Kamal and value your time, this book is absolutely worth it.
Maciej Mensfeld, from Gumroad
❝ I have learned more in 15 minutes than I did previously in hours.
Michael Koper, from Twitter
❝ I love it, and it offers an additional depth and layer to the docs.
Mikael Henriksson, from Twitter
FAQ
Which versions of Kamal are covered?
The 2nd edition of the book covers Kamal 2.x releases while the previous edition covered Kamal 1.x releases. The latest release targets Kamal 2.2.
Is this book just for Rails?
No. 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?
No. 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.
Author
