Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
podman-container-prune(1)    General Commands Manual   podman-container-prune(1)

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 fil-
     ter, 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 cre- |
     |	      | ated  before  given   time- |
     |	      | stamp.			    |
     +--------+-----------------------------+

     The  label  filter  accepts  two  formats.  One  is  the  label=key  or la-
     bel=key=value, which removes containers  with  the  specified  labels.  The
     other  format is the label!=key or label!=key=value, which removes contain-
     ers 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 machineas 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 before the 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 documenta-
     tion by Dan Walsh dwalsh@redhat.com <mailto:dwalsh@redhat.com>

						       podman-container-prune(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-container-prune&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help