Skip to content

Command Line Tools

wheels deploy app remove

Stop and remove app containers for the given version. Scoped to one version — use wheels deploy remove for a broader teardown.

wheels deploy app remove --release=<v> [--role=<name>] [--destination=<name>] [--dry-run]

| Flag | Description | |------|-------------| | --release=<v> | Required. | | --role=<name> | Limit to one role. | | --destination=<name> | Overlay destination config. | | --dry-run | Print commands without executing. |

For each host in each targeted role, chains:

docker stop <service>-<role>-<version> && docker rm <service>-<role>-<version>

Fails per-host if the container doesn't exist.

Prefer wheels deploy prune for retention-policy-driven cleanup. app remove is surgical — it removes exactly the version you named.

illustrative — requires deploy infrastructure
wheels deploy app remove --release=abc1234