wheels deploy remove

Destructive teardown. Stops and removes every app container, proxy container, and accessory container, then logs out of the registry on every host.

Destructive

This removes running containers on every target host. Requires --confirm. There is no undo — re-run wheels deploy setup to bring the environment back.

Synopsis

wheels deploy remove --confirm [--destination=<name>] [--dry-run]

Flags

Flag	Description
--confirm	Required. Without it, the verb throws DeployMainCli.RemoveNotConfirmed.
--destination=<name>	Scope the teardown to one destination.
--dry-run	Print the docker commands that would run without executing. Always start here.

Behavior

1. For every host in every role: docker ps -a --filter label=service=<service> ...|xargs docker rm -f. Broad — removes app containers for every version, not just the current one.
2. Remove kamal-proxy on every host.
3. Remove every declared accessory container.
4. docker logout of the registry on every host.

Volumes attached to accessories persist (they’re named) — docker rm doesn’t take them with it. Follow up with docker volume rm manually if you want a truly clean slate.

Example

example

wheels deploy remove --confirm --dry-run     # always preview first
wheels deploy remove --confirm --destination=staging