.nh
.TH skopeo\-list\-tags(1)
.SH NAME
.PP
skopeo\-list\-tags \- Return a list of tags for the transport\-specific image repository.

.SH SYNOPSIS
.PP
\fBskopeo list\-tags\fP \fIrepository\-name\fP

.PP
Return a list of tags from \fIrepository\-name\fP in a registry.

.PP
\fIrepository\-name\fP name of repository to retrieve tag listing from

.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
\fB\-\-registry\-token\fP \fIBearer token\fP for accessing the registry.

.SH REPOSITORY NAMES
.PP
Repository names are transport\-specific references as each transport may have its own concept of a "repository" and "tags". Currently, only the Docker transport is supported.

.PP
This commands refers to repositories using a \fItransport\fP\fB\fC:\fR\fIdetails\fP format. The following formats are supported:

.PP
\fBdocker://\fP\fIdocker\-repository\-reference\fP
  A repository in a registry implementing the "Docker Registry HTTP API V2". By default, uses the authorization state in either \fB\fC$XDG\_RUNTIME\_DIR/containers/auth.json\fR, which is set using \fB\fC(skopeo login)\fR\&. If the authorization state is not found there, \fB\fC$HOME/.docker/config.json\fR is checked, which is set using \fB\fC(docker login)\fR\&.
  A \fIdocker\-repository\-reference\fP is of the form: \fBregistryhost:port/repositoryname\fP which is similar to an \fIimage\-reference\fP but with no tag or digest allowed as the last component (e.g no \fB\fC:latest\fR or \fB\fC@sha256:xyz\fR)

.PP
.RS

.nf
  Examples of valid docker\-repository\-references:
    "docker.io/myuser/myrepo"
    "docker.io/nginx"
    "docker.io/library/fedora"
    "localhost:5000/myrepository"

  Examples of invalid references:
    "docker.io/nginx:latest"
    "docker.io/myuser/myimage:v1.0"
    "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"

.fi
.RE

.SH EXAMPLES
.SS Docker Transport
.PP
To get the list of tags in the "fedora" repository from the docker.io registry (the repository name expands to "library/fedora" per docker transport canonical form):

.PP
.RS

.nf
$ skopeo list\-tags docker://docker.io/fedora
{
    "Repository": "docker.io/library/fedora",
    "Tags": [
        "20",
        "21",
        "22",
        "23",
        "24",
        "25",
        "26\-modular",
        "26",
        "27",
        "28",
        "29",
        "30",
        "31",
        "32",
        "branched",
        "heisenbug",
        "latest",
        "modular",
        "rawhide"
    ]
}


.fi
.RE

.PP
To list the tags in a local host docker/distribution registry on port 5000, in this case for the "fedora" repository:

.PP
.RS

.nf
$ skopeo list\-tags docker://localhost:5000/fedora
{
    "Repository": "localhost:5000/fedora",
    "Tags": [
        "latest",
        "30",
        "31"
    ]
}


.fi
.RE


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

.SH AUTHORS
.PP
Zach Hill zach@anchore.com
\[la]mailto:zach@anchore.com\[ra]