buildah-rmi(1)

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.  Passing an argument image
15       deletes it, along with any of its dangling (untagged) parent images.
16
17

LIMITATIONS

19              • If the image was pushed to a directory path using  the  'dir:'
20                transport,  the rmi command can not remove the image. Instead,
21                standard file system commands should be used.
22
23              • If imageID is a name, but does not include  a  registry  name,
24                buildah  will attempt to find and remove the named image using
25                the registry name localhost, if no such  image  is  found,  it
26                will search for the intended image by attempting to expand the
27                given name using the names of registries provided in the  sys‐
28                tem's registries configuration file, registries.conf.
29
30              • If  the imageID refers to a manifest list or image index, this
31                command will not do what you expect!  This command will remove
32                the images associated with the manifest list or index (not the
33                manifest list/image index itself). To  remove  that,  use  the
34                buildah manifest rm subcommand instead.
35
36
37

OPTIONS

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

EXAMPLE

65       buildah rmi imageID
66
67
68       buildah rmi --all
69
70
71       buildah rmi --all --force
72
73
74       buildah rmi --prune
75
76
77       buildah rmi --force imageID
78
79
80       buildah rmi imageID1 imageID2 imageID3
81
82

Files

84       registries.conf (/etc/containers/registries.conf)
85
86
87       registries.conf is the configuration file which  specifies  which  con‐
88       tainer registries should be consulted when completing image names which
89       do not include a registry or domain portion.
90
91
92       storage.conf (/etc/containers/storage.conf)
93
94
95       storage.conf is the storage configuration file for all tools using con‐
96       tainers/storage
97
98
99       The storage configuration file specifies all of the available container
100       storage options for tools using shared container storage.
101
102