.nh
.TH skopeo-list-tags(1)
.SH NAME
skopeo-list-tags \- List image names in a transport-specific collection of images.

.SH SYNOPSIS
\fBskopeo list-tags\fP [\fIoptions\fP] \fIsource-image\fP

.PP
Return a list of tags from \fIsource-image\fP in a registry or a local docker-archive file.

.PP
\fIsource-image\fP name of the repository to retrieve a tag listing from or a local docker-archive file.

.SH OPTIONS
See also skopeo(1) for options placed before the subcommand name.

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

.PP
Path of the updated registry credentials file. On Linux, the default is ${XDG_RUNTIME_DIR}/containers/auth.json.
See \fBcontainers-auth.json\fP(5) for more details about the credential search mechanism and defaults on other platforms.

.PP
Use \fBskopeo login\fR to manage the credentials.

.PP
The default value of this option is read from the \fBREGISTRY\\_AUTH\\_FILE\fR environment variable.

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

.PP
\fB--cert-dir\fP \fIpath\fP

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

.PP
\fB--help\fP, \fB-h\fP

.PP
Print usage statement

.PP
\fB--no-creds\fP

.PP
Access the registry anonymously.

.PP
\fB--registry-token\fP \fIBearer token\fP

.PP
Bearer token for accessing the registry.

.PP
\fB--retry-times\fP

.PP
The number of times to retry. By default, no retries are attempted.

.PP
\fB--retry-delay\fP

.PP
Fixed delay between retries. If not set (or set to 0s), retry wait time will be exponentially increased based on the number of failed attempts.

.PP
\fB--tls-verify\fP=\fIbool\fP

.PP
Require HTTPS and verify certificates when talking to the container registry or daemon. Default to registry.conf setting.

.PP
\fB--username\fP

.PP
The username to access the registry.

.PP
\fB--password\fP

.PP
The password to access the registry.

.SH REPOSITORY NAMES
Repository names are transport-specific references as each transport may have its own concept of a "repository" and "tags".

.PP
This commands refers to repositories using a \fItransport\fP\fB:\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".
  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:latest\fR or \fB@sha256:xyz\fR)

.EX
  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"
.EE

.PP
\fBdocker-archive:\fP\fIpath\fP[\fB:\fP\fIdocker-reference\fP]
  Images stored in a \fBdocker save\fR-formatted file

.SH EXAMPLES
.SS Docker Transport
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):

.EX
$ 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"
    ]
}

.EE

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

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

.EE

.SS Docker-archive Transport
To list the tags in a local docker-archive file:

.EX
$ skopeo list-tags docker-archive:/tmp/busybox.tar.gz
{
    "Tags": [
        "busybox:1.28.3"
    ]
}
.EE

.PP
Also supports more than one tags in an archive:

.EX
$ skopeo list-tags docker-archive:/tmp/docker-two-images.tar.gz
{
    "Tags": [
        "example.com/empty:latest",
        "example.com/empty/but:different"
    ]
}
.EE

.PP
Will include a source-index entry for each untagged image:

.EX
$ skopeo list-tags docker-archive:/tmp/four-tags-with-an-untag.tar
{
    "Tags": [
        "image1:tag1",
        "image2:tag2",
        "@2",
        "image4:tag4"
    ]
}
.EE

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

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