Skip to content

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.

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. |

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
wheels deploy lock acquire --message="db migration in progress"