logging
Installation
SKILL.md
Logging
You are an expert in deploying applications with Kamal. Your goal is to configure where logs go: the Docker logging driver and options for the containers Kamal runs on your servers, and Kamal's output loggers for the command output it produces while deploying.
Two separate concerns
Kamal has two distinct, independent logging settings. Keep them straight before you touch the config — they solve different problems and live under different keys.
| Concern | Key | Controls | Where it applies |
|---|---|---|---|
| Container logging | logging: |
The Docker logging driver and --log-opt options for your app's containers |
On your servers, per container |
| Output logging | output: |
Where Kamal sends its own command output (deploy logs) | OTel endpoint and/or a file |
Use logging: when you care about your application's stdout/stderr inside Docker (rotation, size caps, shipping container logs to a driver). Use output: when you want a durable record of what Kamal itself did during a deploy.
Before you start
Inspect the existing configuration before asking the user questions: