summaryrefslogtreecommitdiff
path: root/docs/source/man/podman-image-prune.1.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/man/podman-image-prune.1.md')
-rw-r--r--docs/source/man/podman-image-prune.1.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/source/man/podman-image-prune.1.md b/docs/source/man/podman-image-prune.1.md
new file mode 100644
index 000000000..b844a9f63
--- /dev/null
+++ b/docs/source/man/podman-image-prune.1.md
@@ -0,0 +1,48 @@
+% podman-image-prune(1)
+
+## NAME
+podman-image-prune - Remove all unused images from the local store
+
+## SYNOPSIS
+**podman image prune** [*options*]
+
+## DESCRIPTION
+**podman image prune** removes all dangling images from local storage. With the `all` option,
+you can delete all unused images. Unused images are dangling images as well as any image that
+does not have any containers based on it.
+
+## OPTIONS
+**--all**, **-a**
+
+Remove dangling images and images that have no associated containers.
+
+**--help**, **-h**
+
+Print usage statement
+
+## Examples ##
+
+Remove all dangling images from local storage
+```
+$ sudo podman image prune
+f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
+324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
+```
+
+Remove all unused images from local storage
+```
+$ sudo podman image prune -a
+f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
+324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
+6125002719feb1ddf3030acab1df6156da7ce0e78e571e9b6e9c250424d6220c
+91e732da5657264c6f4641b8d0c4001c218ae6c1adb9dcef33ad00cafd37d8b6
+e4e5109420323221f170627c138817770fb64832da7d8fe2babd863148287fca
+77a57fa8285e9656dbb7b23d9efa837a106957409ddd702f995605af27a45ebe
+
+```
+
+## SEE ALSO
+podman(1), podman-images
+
+## HISTORY
+December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)