skopeo-list-tags - Man Page

Return a list of tags for the transport-specific image repository.


skopeo list-tags repository-name

Return a list of tags from repository-name in a registry.

repository-name name of repository to retrieve tag listing from

--authfile path

Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/containers/auth.json, which is set using skopeo login.
 If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using docker login.

--creds username[:password] for accessing the registry.

--cert-dir path Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.

--tls-verify bool-value Require HTTPS and verify certificates when talking to container registries (defaults to true).

--no-creds bool-value Access the registry anonymously.

--registry-token Bearer token for accessing the registry.

Repository Names

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.

This commands refers to repositories using a transport:details format. The following formats are supported:

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

  Examples of valid docker-repository-references:

  Examples of invalid references:


Docker Transport

To get the list of tags in the "fedora" repository from the registry (the repository name expands to "library/fedora" per docker transport canonical form):

$ skopeo list-tags docker://
    "Repository": "",
    "Tags": [

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

$ skopeo list-tags docker://localhost:5000/fedora
    "Repository": "localhost:5000/fedora",
    "Tags": [

See Also

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


Zach Hill ⟨⟩

Referenced By