NAME

       podman-container-prune - Remove all stopped containers from local storage

SYNOPSIS

       podman container prune [options]

DESCRIPTION

       podman container prune removes all stopped containers from local storage.

OPTIONS

   --filter=filters
       Provide filter values.

       The  filters  argument format is of key=value. If there is more than one filter, then pass
       multiple OPTIONS: --filter foo=bar --filter bif=baz.

       Supported filters:

       ┌───────┬──────────────────────────────────┐
       │Filter │ Description                      │
       ├───────┼──────────────────────────────────┤
       │label  │ Only remove containers, with (or │
       │       │ without,    in   the   case   of │
       │       │ label!=[...]   is   used)    the │
       │       │ specified labels.                │
       ├───────┼──────────────────────────────────┤
       │until  │ Only  remove  containers created │
       │       │ before given timestamp.          │
       └───────┴──────────────────────────────────┘

       The label filter accepts two formats. One  is  the  label=key  or  label=key=value,  which
       removes  containers  with  the  specified  labels.  The  other format is the label!=key or
       label!=key=value, which removes containers without the specified labels.

       The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings
       (e.g. 10m, 1h30m) computed relative to the machine’s time.

   --force, -f
       Do not provide an interactive prompt for container removal.
       The default is false.

       -h, --help

       Print usage statement.
       The default is false.

EXAMPLES

       Remove all stopped containers from local storage

              $ podman container prune
              WARNING! This will remove all stopped containers.
              Are you sure you want to continue? [y/N] y
              878392adf2e6c5c9bb1fc19b69d37d2e98c8abf9d539c0bce4b15b46bbcce471
              37664467fbe3618bf9479c34393ac29c02696675addf1750f9e346581636cde7
              ed0c6468b8e1cb641b4621d1fe30cb477e1fefc5c0bceb66feaf2f7cb50e5962
              6ac6c8f0067b7a4682e6b8e18902665b57d1a0e07e885d9abcd382232a543ccd
              fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
              602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5

       Remove all stopped containers from local storage without confirmation.

              $ podman container prune -f
              878392adf2e6c5c9bb1fc19b69d37d2e98c8abf9d539c0bce4b15b46bbcce471
              37664467fbe3618bf9479c34393ac29c02696675addf1750f9e346581636cde7
              ed0c6468b8e1cb641b4621d1fe30cb477e1fefc5c0bceb66feaf2f7cb50e5962
              6ac6c8f0067b7a4682e6b8e18902665b57d1a0e07e885d9abcd382232a543ccd
              fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
              602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5

       Remove all stopped containers from local storage created within last 10 minutes

              $ podman container prune --filter until="10m"
              WARNING! This will remove all stopped containers.
              Are you sure you want to continue? [y/N] y
              3d366295e33d8cc612c4d873199bacadd55088d90d17dcafaa9a2d317ad50b4e

SEE ALSO

       podman(1), podman-ps(1)

HISTORY

       December     2018,     Originally    compiled    by    Brent    Baude    bbaude@redhat.com
       ⟨mailto:bbaude@redhat.com⟩
       December 2020, converted filter information  from  docs.docker.com  documentation  by  Dan
       Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩

                                                                        podman-container-prune(1)