1buildah-rmi(1) General Commands Manual buildah-rmi(1)
2
3
4
6 buildah-rmi - Removes one or more images.
7
8
10 buildah rmi [image ...]
11
12
14 Removes one or more locally stored images.
15
16
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
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
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
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
81 buildah(1), registries.conf(5)
82
83
84
85buildah March 2017 buildah-rmi(1)