Kamal Handbook

Kamal Handbook is the missing manual for the new Kamal deploy tool which lets you run Docker in production with minimal effort.

Includes a foreword by Donal McBreen,
Kamal contributor and Lead Programmer at 37signals.

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


1. Introduction

Philosophy, components, and terminology.

2. Workflow

How do deployments happen in Kamal?

3. Prerequisites

Kamal expectations.

4. Installation

Run as a gem or Docker container.

5. The first deploy

Let's deploy something.

6. Server configuration

Dive in on roles and other configurations.

7. Environment

Environment and secrets.

8. Traefik

Traefik routers and configuration.

9. Destinations

Splitting staging from production.

10. Volumes and data

Kamal and Docker volumes.

11. Assets

Learn about asset bridging.

12. Accessories

Ship databases and micro-services.

13. Logging

Configure log drivers.

14. Maintainance

Run maintenance tasks.

15. Examples

Production single and multi-server Kamal setup.

16. Debugging

What to do when things go wrong.

17. CI/CD

Automatic deployment with GitHub Actions.

18. Cron

Schedule tasks with cron.

19. Backups

Creating and restoring backups.

20. Wrap-up

What we learned and what's next.

The one-page preview

Buy a copy

Starting at $16.99 + local tax


❝ 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


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.

Buy now

Starting at $16.99 + local tax


Hello, I am Josef, a formal Linux packager at Red Hat and an author of Deployment from Scratch. Once I found Kamal, I dived in and never looked back. I am now running everything with Kamal for myself and my clients. In the book I am sharing everything I know, so you are confident to do the same.