1buildah-rmi(1)              General Commands Manual             buildah-rmi(1)
2
3
4

NAME

6       buildah-rmi - Removes one or more images.
7
8

SYNOPSIS

10       buildah rmi [image ...]
11
12

DESCRIPTION

14       Removes one or more locally stored images.
15
16

LIMITATIONS

18       If  the image was pushed to a directory path using the 'dir:' transport
19       the rmi command can not remove the image.  Instead standard file system
20       commands  should be used.  If imageID is a name, but does not include a
21       registry name, buildah will attempt to find and remove an  image  named
22       using  the  registry name localhost, if no such image is found, it will
23       search for the intended image by attempting to expand  the  given  name
24       using  the names of registries provided in the system's registries con‐
25       figuration file, registries.conf.
26
27

OPTIONS

29       --all, -a
30
31
32       All local images will be removed from the system that do not have  con‐
33       tainers using the image as a reference image.  An image name or id can‐
34       not be provided when this option is used.  Read/Only images  configured
35       by  modifying the  "additionalimagestores" in the /etc/containers/stor‐
36       age.conf file, can not be removed.
37
38
39       --prune, -p
40
41
42       All local images will be removed from the system that do not have a tag
43       and  do  not  have a child image pointing to them.  An image name or id
44       cannot be provided when this option is used.
45
46
47       --force, -f
48
49
50       This option will cause Buildah to remove all containers that are  using
51       the image before removing the image from the system.
52
53

EXAMPLE

55       buildah rmi imageID
56
57
58       buildah rmi --all
59
60
61       buildah rmi --all --force
62
63
64       buildah rmi --prune
65
66
67       buildah rmi --force imageID
68
69
70       buildah rmi imageID1 imageID2 imageID3
71
72

Files

74       registries.conf (/etc/containers/registries.conf)
75
76
77       registries.conf  is  the  configuration file which specifies which con‐
78       tainer registries should be consulted when completing image names which
79       do not include a registry or domain portion.
80
81
82       storage.conf (/etc/containers/storage.conf)
83
84
85       storage.conf is the storage configuration file for all tools using con‐
86       tainers/storage
87
88
89       The storage configuration file specifies all of the available container
90       storage options for tools using shared container storage.
91
92

SEE ALSO

94       buildah(1), registries.conf(5), containers-storage.conf(5)
95
96
97
98buildah                           March 2017                    buildah-rmi(1)
Impressum