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                           │
       ├────────┼───────────────────────────────────────┤
       │ until  │ Only  remove  containers  and  images │
       │        │ created before given timestamp.       │
       ├────────┼───────────────────────────────────────┤
       │ label  │ Only  remove  containers  and images, │
       │        │ with (or  without,  in  the  case  of │
       │        │ label!=[...]  is  used) 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.

       The  label  filter  accepts  two formats. One is the label=key, 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.

   --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

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)()