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.
| Verb | Purpose |
|------|---------|
| acquire | Manually take the lock. |
| release | Manually release the lock. |
| status | Report whether the lock is held and who holds it. |
The lock
Section titled “The lock”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.