FreeBSD Manual Pages
podman-system-prune(1) General Commands Manual podman-system-prune(1) NAME podman-system-prune - Remove all unused pods, containers, images, net- works, and volume data SYNOPSIS podman system prune [options] DESCRIPTION podman system prune removes all unused containers (both dangling and unreferenced), build containers, pods, networks, and optionally, vol- umes from local storage. Use the --all option to delete all unused images. Unused images are dangling images as well as any image that does not have any containers based on it. By default, volumes are not removed to prevent important data from be- ing deleted if there is currently no container using the volume. Use the --volumes flag when running the command to prune volumes as well. By default, build containers are not removed to prevent interference with builds in progress. Use the --build flag when running the command to remove build containers as well. OPTIONS --all, -a Recursively remove all unused pods, containers, images, networks, and volume data. (Maximum 50 iterations.) --build Removes any build containers that were created during the build, but were not removed because the build was unexpectedly terminated. Note: This is not safe operation and should be executed only when no builds are in progress. It can interfere with builds in progress. --external Tries to clean up remainders of previous containers or layers that are not references in the storage json files. These can happen in the case of unclean shutdowns or regular restarts in transient storage mode. However, when using transient storage mode, the Podman database does not persist. This means containers leave the writable layers on disk after a reboot. When using a transient store, it is recommended that the podman system prune --external command is run during boot. This option is incompatible with --all and --filter and drops the de- fault behaviour of removing unused resources. --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 and | | | images, with (or without, | | | in the case of la- | | | bel!=[...] is used) the | | | specified labels. | +--------+----------------------------+ | until | Only remove containers and | | | images created before | | | given timestamp. | +--------+----------------------------+ The label filter accepts two formats. One is the label=key or la- bel=key=value, which removes containers and images with the specified labels. The other format is the label!=key or label!=key=value, which removes containers and images 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 machines time. --force, -f Do not prompt for confirmation --help, -h Print usage statement --volumes Prune volumes currently unused by any container EXAMPLES Prune all containers, pods, networks and dangling images. $ podman system prune WARNING! This command removes: - all stopped containers - all networks not used by at least one container - all dangling images - all dangling build cache Are you sure you want to continue? [y/N] y Total reclaimed space: 0B Prune all containers, pods, and networks that are not in use. $ podman system prune --all WARNING! This command removes: - all stopped containers - all networks not used by at least one container - all images without at least one container associated with them - all build cache Are you sure you want to continue? [y/N] y Deleted Images ce21f047f73644dcb9cd55ad247433fb47ade48ad4f4e676881fbcb2d5735c76 c874afc1f445044eaa821da0c32328707406e546a688d8c4c22587a5f88a1992 2fce09cfad57c6de112654eeb6f6da1851f3ced1cff7ac0002378642c2c7ca84 0cd6d2e072175191823999cd189f8d262ba5e460271095570d8cffb1d9072e9a 172bdaffe628cc7b7f8b7b6695438afc612a9833382f5968a06740a3804c3b64 bf07fec943ec23054f3b81c0e65926a1c83dc82c50933dc6372c60e09fdb2d4f b2f735cbb571dd6a28e66455af0623ecc81f9c5b74259d3e04b3bac3b178e965 cea2ff433c610f5363017404ce989632e12b953114fefc6f597a58e813c15d61 Deleted Networks podman-default-kube-network Total reclaimed space: 3.372GB Prune all containers, build containers, pods, networks and dangling im- ages. $ podman system prune --build WARNING! This command removes: - all stopped containers - all networks not used by at least one container - all build containers - all dangling images - all dangling build cache Are you sure you want to continue? [y/N] y Deleted Containers a8bfed41990114767c933d27bf5508b01cdc0f641dc36037b349648347c6ea64 Deleted Images 055733a33e7a78efa27d3c682df97a9e0489133bef071745144c8d0edda2d708 Total reclaimed space: 1.4GB With --force flag $ podman system prune --force Total reclaimed space: 0B SEE ALSO podman(1), podman-system(1) HISTORY February 2019, Originally compiled by Dan Walsh (dwalsh at redhat dot com) December 2020, converted filter information from docs.docker.com documentation by Dan Walsh (dwalsh at redhat dot com) podman-system-prune(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-system-prune&sektion=1&manpath=FreeBSD+Ports+15.0>