Skip to content

Command Line Tools

wheels deploy lock

Deploy-lock management. The rolling wheels deploy flow acquires and releases a per-service lock automatically; these verbs expose manual escape hatches.

VerbPurpose
acquireManually take the lock.
releaseManually release the lock.
statusReport whether the lock is held and who holds it.

One file per service at /tmp/kamal_deploy_lock_<service>. Created by symlink for atomicity — if another deploy is running, the symlink creation fails and the verb errors. Released when wheels deploy exits (success or failure).

A stale lock after a crashed deploy blocks new deploys — use lock release to clear it. Always run lock status first to confirm it isn’t actually held by someone else.