Skip to content

Command Line Tools

wheels deploy audit

Tail the on-host audit log. Every deploy appends an entry with the actor, version, and timestamp to /tmp/kamal-audit.log on every host; audit reads the last N lines from each host and streams them back.

wheels deploy audit [--tail=<N>] [--destination=<name>] [--dry-run]
FlagDescription
--tail=<N>Number of trailing lines per host. Default 100.
--destination=<name>Overlay deploy.<name>.yml.
--dry-runPrint the tail command that would run.

Dispatches tail -n <N> /tmp/kamal-audit.log to every host in parallel, prefixes output by host. Entries are plain text — one event per line.

The audit log is on ephemeral /tmp, so it doesn’t survive host reboots. For durable audit, pipe the log into your observability stack via a hook — see Hooks.

illustrative — requires live deploy host
wheels deploy audit
wheels deploy audit --tail=500 --destination=production