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]
FlagDescription
--release=<v>Required.
--role=<name>Limit to one role.
--destination=<name>Overlay destination config.
--dry-runPrint 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