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.
35
36
37       --prune, -p
38
39
40       All local images will be removed from the system that do not have a tag
41       and  do  not  have a child image pointing to them.  An image name or id
42       cannot be provided when this option is used.
43
44
45       --force, -f
46
47
48       This option will cause Buildah to remove all containers that are  using
49       the image before removing the image from the system.
50
51

EXAMPLE

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

Files

72       registries.conf (/etc/containers/registries.conf)
73
74
75       registries.conf  is  the  configuration file which specifies which con‐
76       tainer registries should be consulted when completing image names which
77       do not include a registry or domain portion.
78
79

SEE ALSO

81       buildah(1), registries.conf(5)
82
83
84
85buildah                           March 2017                    buildah-rmi(1)
Impressum