rollback

Revert Kamal deployments to previous local container images.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/donnfelker/kamal-skills --skill rollback-donnfelker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rollback
Source: https://github.com/donnfelker/kamal-skills/tree/main/skills/rollback
Command: npx skills add https://github.com/donnfelker/kamal-skills --skill rollback-donnfelker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves production incidents caused by faulty deployments by enabling rapid, reliable rollbacks to previously known-good container images without requiring registry downloads.

Core Features & Use Cases

  • Version Identification: Quickly list and verify available container versions using native Kamal commands.
  • Instant Reversion: Execute immediate rollbacks by switching to existing local images, bypassing the need for network-heavy registry pulls.
  • Verification: Confirm the state of your infrastructure post-rollback to ensure service stability.

Quick Start

Ask the agent to list available versions and roll back the current deployment to the last known healthy container image.

Frequently Asked Questions about rollback

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

FAQPage Schema
How do I rollback a Kamal deployment to a previous container version?

To rollback a Kamal deployment, you execute commands to identify existing local container images and instantly switch the active service to a previously known-good version without requiring registry downloads.

Can I revert a faulty container deployment without pulling from the registry?

Yes, you can revert a faulty container deployment without network-heavy registry pulls by switching directly to existing local images already present on the host to facilitate rapid incident response.

How does reverting a Kamal deployment to a local container image work?

Reverting a Kamal deployment works by using native Kamal CLI commands to inspect container status, identify available local versions, and execute an atomic service switch to a previous image.

Do I need the Kamal CLI installed to revert my application deployment?

Yes, you need access to Kamal CLI commands because the rollback process relies on native Kamal utilities to inspect current container status and perform the atomic service switch.

What is the best way to list available container versions before rolling back?

The best way to list available container versions is to ask the agent to use native Kamal commands to quickly identify and verify existing local images before executing the rollback.

How do I verify infrastructure stability after a Kamal rollback?

To verify infrastructure stability after a Kamal rollback, you confirm the state of your containerized services post-rollback to ensure the reverted version is running and stable.