.nh
.TH skopeo\-delete(1)
.SH NAME
.PP
skopeo\-delete \- Mark the \fIimage\-name\fP for later deletion by the registry's garbage collector.

.SH SYNOPSIS
.PP
\fBskopeo delete\fP \fIimage\-name\fP

.PP
Mark \fIimage\-name\fP for deletion.  To release the allocated disk space, you must login to the container registry server and execute the container registry garbage collector. E.g.,

.PP
.RS

.nf
/usr/bin/registry garbage\-collect /etc/docker\-distribution/registry/config.yml

Note: sometimes the config.yml is stored in /etc/docker/registry/config.yml

If you are running the container registry inside of a container you would execute something like:

$ docker exec \-it registry /usr/bin/registry garbage\-collect /etc/docker\-distribution/registry/config.yml


.fi
.RE

.PP
\fB\-\-authfile\fP \fIpath\fP

.PP
Path of the authentication file. Default is ${XDG\_RUNTIME\_DIR}/containers/auth.json, which is set using \fB\fCskopeo login\fR\&.
  If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using \fB\fCdocker login\fR\&.

.PP
\fB\-\-creds\fP \fIusername[:password]\fP for accessing the registry.

.PP
\fB\-\-cert\-dir\fP \fIpath\fP Use certificates at \fIpath\fP (*.crt, *.cert, *.key) to connect to the registry.

.PP
\fB\-\-tls\-verify\fP \fIbool\-value\fP Require HTTPS and verify certificates when talking to container registries (defaults to true).

.PP
\fB\-\-no\-creds\fP \fIbool\-value\fP Access the registry anonymously.

.PP
Additionally, the registry must allow deletions by setting \fB\fCREGISTRY\_STORAGE\_DELETE\_ENABLED=true\fR for the registry daemon.

.PP
\fB\-\-registry\-token\fP \fIBearer token\fP for accessing the registry.

.SH EXAMPLES
.PP
Mark image example/pause for deletion from the registry.example.com registry:

.PP
.RS

.nf
$ skopeo delete \-\-force docker://registry.example.com/example/pause:latest

.fi
.RE

.PP
See above for additional details on using the command \fBdelete\fP\&.

.SH SEE ALSO
.PP
skopeo(1), skopeo\-login(1), docker\-login(1), containers\-auth.json(5)

.SH AUTHORS
.PP
Antonio Murdaca runcom@redhat.com
\[la]mailto:runcom@redhat.com\[ra], Miloslav Trmac mitr@redhat.com
\[la]mailto:mitr@redhat.com\[ra], Jhon Honce jhonce@redhat.com
\[la]mailto:jhonce@redhat.com\[ra]