Command Line Tools
wheels deploy lock acquire
Manually take the deploy lock. Useful when running an out-of-band maintenance task that you want to serialize against normal deploys.
Synopsis
Section titled “Synopsis”wheels deploy lock acquire [--message=<string>] [--destination=<name>] [--dry-run]| Flag | Description |
|---|---|
--message=<string> | Free-form message stored in the lock file. Default manual acquire. |
--destination=<name> | Overlay destination config. |
--dry-run | Print the commands without executing. |
Behavior
Section titled “Behavior”Emits the atomic lock-acquire command (ln -s against /tmp/kamal_deploy_lock_<service>) on any single host. Fails if the lock is already held — run lock status to see who holds it.
Example
Section titled “Example”wheels deploy lock acquire --message="db migration in progress"