1skopeo-delete(1)()                                          skopeo-delete(1)()
2
3
4

NAME

6       skopeo-delete  -  Mark  the  image-name  for later deletion by the reg‐
7       istry's garbage collector.
8
9

SYNOPSIS

11       skopeo delete [options] image-name
12
13
14       Mark image-name for deletion.  To release the allocated disk space, you
15       must  login  to the container registry server and execute the container
16       registry garbage collector. E.g.,
17
18
19              /usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml
20
21              Note: sometimes the config.yml is stored in /etc/docker/registry/config.yml
22
23              If you are running the container registry inside of a container you would execute something like:
24
25              $ docker exec -it registry /usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml
26
27
28
29

OPTIONS

31       --authfile path
32
33
34       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
35       ers/auth.json,  which  is set using skopeo login.  If the authorization
36       state is not found there, $HOME/.docker/config.json is  checked,  which
37       is set using docker login.
38
39
40       --creds username[:password]
41
42
43       Credentials for accessing the registry.
44
45
46       --cert-dir path
47
48
49       Use  certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
50       istry.
51
52
53       --daemon-host host
54
55
56       Use docker daemon host at host (docker-daemon: transport only)
57
58
59       --help, -h
60
61
62       Print usage statement
63
64
65       --no-creds bool-value
66
67
68       Access the registry anonymously.
69
70
71       Additionally,  the  registry  must  allow  deletions  by  setting  REG‐
72       ISTRY_STORAGE_DELETE_ENABLED=true for the registry daemon.
73
74
75       --registry-token token
76
77
78       Bearer token for accessing the registry.
79
80
81       --retry-times
82
83
84       The number of times to retry. Retry wait time will be exponentially in‐
85       creased based on the number of failed attempts.
86
87
88       --shared-blob-dir directory
89
90
91       Directory to use to share blobs across OCI repositories.
92
93
94       --tls-verify=bool
95
96
97       Require HTTPS and verify certificates when  talking  to  the  container
98       registry or daemon. Default to registry.conf setting.
99
100
101       --username
102
103
104       The username to access the registry.
105
106
107       --password
108
109
110       The password to access the registry.
111
112

EXAMPLES

114       Mark  image  example/pause  for  deletion from the registry.example.com
115       registry:
116
117
118              $ skopeo delete --force docker://registry.example.com/example/pause:latest
119
120
121
122       See above for additional details on using the command delete.
123
124

SEE ALSO

126       skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
127
128

AUTHORS

130       Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩,  Miloslav
131       Trmac  mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@red‐
132       hat.com ⟨mailto:jhonce@redhat.com⟩
133
134
135
136                                                            skopeo-delete(1)()
Impressum