NAME

       podman-rm - Remove one or more containers

SYNOPSIS

       podman rm [options] container

       podman container rm [options] container

DESCRIPTION

       podman  rm will remove one or more containers from the host.  The container name or ID can be used.  This
       does not remove images.  Running or unusable containers will not be removed without the -f option.

OPTIONS

   --all, -a
       Remove all containers.  Can be used in conjunction with -f as well.

   --cidfile
       Read container ID from the specified file and remove the container.  Can be specified multiple times.

   --force, -f
       Force the removal of running and paused containers. Forcing a container removal also  removes  containers
       from  container storage even if the container is not known to podman.  Containers could have been created
       by a different container engine.  In addition, forcing can be used to remove  unusable  containers,  e.g.
       containers whose OCI runtime has become unavailable.

   --ignore, -i
       Ignore  errors  when  specified  containers are not in the container store.  A user might have decided to
       manually remove a container which would lead to a failure during the  ExecStop  directive  of  a  systemd
       service referencing that container.

   --latest, -l
       Instead  of  providing the container name or ID, use the last created container. If you use methods other
       than Podman to run containers such as CRI-O, the last started container could be  from  either  of  those
       methods. (This option is not available with the remote Podman client)

   --volumes, -v
       Remove  anonymous volumes associated with the container. This does not include named volumes created with
       podman volume create, or the --volume option of podman run and podman create.

EXAMPLE

       Remove a container by its name mywebserver

              $ podman rm mywebserver

       Remove several containers by name and container id.

              $ podman rm mywebserver myflaskserver 860a4b23

       Remove several containers reading their IDs from files.

              $ podman rm --cidfile ./cidfile-1 --cidfile /home/user/cidfile-2

       Forcibly remove a container by container ID.

              $ podman rm -f 860a4b23

       Remove all containers regardless of its run state.

              $ podman rm -f -a

       Forcibly remove the latest container created.

              $ podman rm -f --latest

Exit Status

       0   All specified containers removed

       1   One of the specified containers did not exist, and no other failures

       2   One of the specified containers is paused or running

       125 The command fails for any other reason

SEE ALSO

       podman(1), podman-image-rm(1), podman-ps(1), podman-build(1), buildah(1), cri-o(1)

HISTORY

       August 2017, Originally compiled by Ryan Cole rycole@redhat.com ⟨mailto:rycole@redhat.com⟩

                                                                                                  podman-rm(1)()