2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
|
title: "image prune"
|
|
|
|
|
description: "Remove all stopped images"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "image, prune, delete, remove"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2016-08-31 12:57:32 -04:00
|
|
|
|
2016-10-19 13:25:45 -04:00
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
|
|
|
repository at https://github.com/docker/docker/. Make all
|
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
|
will be rejected.
|
|
|
|
|
-->
|
|
|
|
|
|
2016-08-31 12:57:32 -04:00
|
|
|
# image prune
|
|
|
|
|
|
|
|
|
|
```markdown
|
2016-10-10 11:07:32 -04:00
|
|
|
Usage: docker image prune [OPTIONS]
|
2016-08-31 12:57:32 -04:00
|
|
|
|
|
|
|
|
Remove unused images
|
|
|
|
|
|
|
|
|
|
Options:
|
|
|
|
|
-a, --all Remove all unused images, not just dangling ones
|
|
|
|
|
-f, --force Do not prompt for confirmation
|
|
|
|
|
--help Print usage
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Remove all dangling images. If `-a` is specified, will also remove all images not referenced by any container.
|
|
|
|
|
|
|
|
|
|
Example output:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
$ docker image prune -a
|
|
|
|
|
WARNING! This will remove all images without at least one container associated to them.
|
|
|
|
|
Are you sure you want to continue? [y/N] y
|
|
|
|
|
Deleted Images:
|
|
|
|
|
untagged: alpine:latest
|
|
|
|
|
untagged: alpine@sha256:3dcdb92d7432d56604d4545cbd324b14e647b313626d99b889d0626de158f73a
|
|
|
|
|
deleted: sha256:4e38e38c8ce0b8d9041a9c4fefe786631d1416225e13b0bfe8cfa2321aec4bba
|
|
|
|
|
deleted: sha256:4fe15f8d0ae69e169824f25f1d4da3015a48feeeeebb265cd2e328e15c6a869f
|
|
|
|
|
untagged: alpine:3.3
|
|
|
|
|
untagged: alpine@sha256:4fa633f4feff6a8f02acfc7424efd5cb3e76686ed3218abf4ca0fa4a2a358423
|
|
|
|
|
untagged: my-jq:latest
|
|
|
|
|
deleted: sha256:ae67841be6d008a374eff7c2a974cde3934ffe9536a7dc7ce589585eddd83aff
|
|
|
|
|
deleted: sha256:34f6f1261650bc341eb122313372adc4512b4fceddc2a7ecbb84f0958ce5ad65
|
|
|
|
|
deleted: sha256:cf4194e8d8db1cb2d117df33f2c75c0369c3a26d96725efb978cc69e046b87e7
|
|
|
|
|
untagged: my-curl:latest
|
|
|
|
|
deleted: sha256:b2789dd875bf427de7f9f6ae001940073b3201409b14aba7e5db71f408b8569e
|
|
|
|
|
deleted: sha256:96daac0cb203226438989926fc34dd024f365a9a8616b93e168d303cfe4cb5e9
|
|
|
|
|
deleted: sha256:5cbd97a14241c9cd83250d6b6fc0649833c4a3e84099b968dd4ba403e609945e
|
|
|
|
|
deleted: sha256:a0971c4015c1e898c60bf95781c6730a05b5d8a2ae6827f53837e6c9d38efdec
|
|
|
|
|
deleted: sha256:d8359ca3b681cc5396a4e790088441673ed3ce90ebc04de388bfcd31a0716b06
|
|
|
|
|
deleted: sha256:83fc9ba8fb70e1da31dfcc3c88d093831dbd4be38b34af998df37e8ac538260c
|
|
|
|
|
deleted: sha256:ae7041a4cc625a9c8e6955452f7afe602b401f662671cea3613f08f3d9343b35
|
|
|
|
|
deleted: sha256:35e0f43a37755b832f0bbea91a2360b025ee351d7309dae0d9737bc96b6d0809
|
|
|
|
|
deleted: sha256:0af941dd29f00e4510195dd00b19671bc591e29d1495630e7e0f7c44c1e6a8c0
|
|
|
|
|
deleted: sha256:9fc896fc2013da84f84e45b3096053eb084417b42e6b35ea0cce5a3529705eac
|
|
|
|
|
deleted: sha256:47cf20d8c26c46fff71be614d9f54997edacfe8d46d51769706e5aba94b16f2b
|
|
|
|
|
deleted: sha256:2c675ee9ed53425e31a13e3390bf3f539bf8637000e4bcfbb85ee03ef4d910a1
|
|
|
|
|
|
|
|
|
|
Total reclaimed space: 16.43 MB
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Related information
|
|
|
|
|
|
|
|
|
|
* [system df](system_df.md)
|
|
|
|
|
* [container prune](container_prune.md)
|
2016-10-10 11:26:05 -04:00
|
|
|
* [volume prune](volume_prune.md)
|
2016-10-18 00:36:52 -04:00
|
|
|
* [network prune](network_prune.md)
|
2016-08-31 12:57:32 -04:00
|
|
|
* [system prune](system_prune.md)
|
