skills.rest
donnfelker
donnfelkerCOMMUNITY
Explore all skills by this author →
Website𝕏@donnfelkerGitHub

upgrade

Migrate Kamal 1.x deployment configurations to Kamal 2.0 standards.

Updated Jun 30, 2026
Search Tags:#devops#deployment#migration#infrastructure#proxy#kamal
One-click install
npx skills add https://github.com/donnfelker/kamal-skills --skill upgrade-donnfelker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrade
Source: https://github.com/donnfelker/kamal-skills/tree/main/skills/upgrade
Command: npx skills add https://github.com/donnfelker/kamal-skills --skill upgrade-donnfelker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill simplifies the complex, multi-step migration from Kamal 1.x to 2.0, ensuring that configuration changes, secret management, and proxy transitions are handled correctly without breaking your production environment.

Core Features & Use Cases

  • Configuration Conversion: Automatically maps legacy Traefik configurations to the new kamal-proxy structure and updates builder architecture settings.
  • Secret Migration: Guides the secure transition of environment variables from .env files to the new .kamal/secrets format.
  • Zero-Downtime Upgrades: Provides workflows for rolling upgrades and host-by-host transitions to maintain service availability during the migration.

Quick Start

Use the upgrade skill to guide me through the step-by-step process of migrating my existing Kamal 1.9 project to Kamal 2.0.

Frequently Asked Questions about upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Kamal 1.x to 2.0 without downtime?▼

Migrating Kamal 1.x to 2.0 is facilitated through rolling upgrade workflows and host-by-host transitions. This ensures service availability is maintained while updating proxy, network, and secret management configurations.

What is the best way to transition Traefik configurations to kamal-proxy?▼

Transitioning Traefik configurations to kamal-proxy is handled by automatically mapping legacy proxy settings to the new kamal-proxy structure. This configuration conversion also updates builder architecture settings for Kamal 2.0 compatibility.

How do I move environment variables to .kamal/secrets during a Kamal upgrade?▼

Moving environment variables to .kamal/secrets during a Kamal upgrade involves a guided secure transition from standard .env files. This ensures secrets are correctly formatted and managed within the new Kamal 2.0 standards.

Can I downgrade my deployment back to Kamal 1.x after upgrading?▼

Downgrading back to Kamal 1.x after upgrading is supported through backward-compatible downgrade paths. The migration process includes configuration validation to ensure a safe return to previous infrastructure setups if needed.

Does Kamal 2.0 migration support configuration validation for existing infrastructure?▼

Kamal 2.0 migration supports configuration validation for existing infrastructure setups. This ensures that proxy transitions, network updates, and secret management changes are verified before applying rolling deployments.

Related Skills

Explore More Software Engineering Skills→
donnfelkerdonnfelker

proxy

coming soon

Community
Advanced
bastosbastos
3

kamal

Automate Rails application deployment with Kamal commands and configuration.

Community
Advanced
pluginagentmarketplacepluginagentmarketplace
3

devops

Automate Linux DevOps workflows for CI/CD, configuration, and deployment.

Community
Advanced
donnfelkerdonnfelker

secrets

Manage sensitive environment variables and credentials for Kamal deployments.

Community
Advanced