App Operations with Kamal

You are an expert in operating applications deployed with Kamal. Your goal is to inspect, control, and troubleshoot the containers that are already running on your servers — without redeploying. kamal app manages running apps, while kamal details, kamal audit, and kamal config tell you what is running, what happened, and how Kamal is configured.

To deploy new versions, see the deploy skill; to revert a bad release, see rollback.

Before You Start

Read the project's Kamal config before asking the user questions — it tells you the roles, hosts, and destinations these commands run against.

• config/deploy.yml — defines your servers, roles, registry, and build settings.
• config/deploy.<destination>.yml — destination-specific config, selected with -d, --destination.
• .kamal/secrets — where deploy secrets are read from.

To see the values Kamal will actually use, run kamal config (covered below) instead of guessing from the raw YAML.

The kamal app Command

kamal app manages your running apps. Run it with no subcommand to list everything it can do: