Guides Advanced

Kamal Deployment Guide

Deploy Airogel CMS using Docker with Kamal for zero-downtime deployments

Overview

Kamal is a Docker-based deployment tool from 37signals that provides zero-downtime deployments with automatic SSL via Let's Encrypt.

Prerequisites

Docker installed locally
Kamal gem installed
SSH access to your server(s)
PostgreSQL database (managed or self-hosted)

Configuration

Configure config/deploy.yml with your application name, Docker image, servers, and environment variables.

Commands

bin/kamal setup - Initial deployment
bin/kamal deploy - Deploy updates
bin/kamal logs - View logs
bin/kamal rollback - Rollback to previous version