Setup

Kamal Setup

Install Kamal locally and verify CLI access before deployment.

When to use this page

You need Kamal CLI installed on your local machine.
You are preparing to run kamal setup and kamal deploy.

Prerequisites

Terminal access on your local machine.
RubyGems available.

Install

Kamal installation documentation

Quick install

gem install kamal -N

-N skips local docs install and keeps setup faster.

Verify

kamal version

You should see installed Kamal version output.

Troubleshooting

kamal command not found: Reopen terminal or verify Ruby gem bin path is in PATH.
Permission error during install: Use your Ruby manager gem path or run install with proper user permissions.

Hetzner Account

Create and prepare a Hetzner account and project for VPS deployment.

Keypair Generation

Create and install SSH keys for Kamal deploy access.

On this page

When to use this page Prerequisites Install Quick install Verify Troubleshooting