- bookworm 4.3.1+ds1-8+deb12u1
- testing 5.2.2+ds1-2
- unstable 5.2.2+ds1-2
- experimental 5.2.2+ds1-3
podman-container-cleanup(1) | General Commands Manual | podman-container-cleanup(1) |
NAME¶
podman-container-cleanup - Clean up the container's network and mountpoints
SYNOPSIS¶
podman container cleanup [options] container [container ...]
DESCRIPTION¶
podman container cleanup cleans up exited containers
by removing all mountpoints and network configuration from the host. The
container name or ID can be used. The cleanup command does not
remove the containers. Running containers will not be cleaned
up.
Sometimes container mount points and network stacks can remain if the podman
command was killed or the container ran in daemon mode. This command
is automatically executed when containers are run in daemon mode by
the conmon process when the container exits.
OPTIONS¶
--all, -a¶
Clean up all containers.
The default is false.
IMPORTANT: This OPTION does not need a container name or ID as input
argument.
--exec=session¶
Clean up an exec session for a single container. Can only
be specified if a single container is being cleaned up (conflicts
with --all as such). If --rm is not specified, temporary files
for the exec session will be cleaned up; if it is, the exec session will be
removed from the container.
*IMPORTANT: Conflicts with --rmi as the container is not being cleaned
up so the image cannot be removed.*
--latest, -l¶
Instead of providing the container ID or name, use
the last created container. If other methods than Podman are used to
run containers such as CRI-O, the last started
container could be from either of those methods.
The default is false.
IMPORTANT: This OPTION is not available with the remote Podman client,
including Mac and Windows (excluding WSL2) machines. This OPTION does not
need a container name or ID as input argument.
--rm¶
After cleanup, remove the container entirely.
The default is false.
--rmi¶
After cleanup, remove the image entirely.
The default is false.
EXAMPLES¶
Clean up the container "mywebserver".
$ podman container cleanup mywebserver
Clean up the containers with the names "mywebserver", "myflaskserver", "860a4b23".
$ podman container cleanup mywebserver myflaskserver 860a4b23
SEE ALSO¶
podman(1), podman-container(1), conmon(8)
HISTORY¶
Jun 2018, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩