.nh
.TH skopeo-inspect(1)
.SH NAME
skopeo-inspect \- Return low-level information about \fIimage-name\fP in a registry.

.SH SYNOPSIS
\fBskopeo inspect\fP [\fIoptions\fP] \fIimage-name\fP

.SH DESCRIPTION
Return low-level information about \fIimage-name\fP in a registry.
See skopeo(1) for the format of \fIimage-name\fP\&.

.PP
The default output includes data from various sources: user input (\fBName\fP), the remote repository, if any (\fBRepoTags\fP), the top-level manifest (\fBDigest\fP),
and a per-architecture/OS image matching the current run-time environment (most other values).
To see values for a different architecture/OS, use the \fB--override-os\fP / \fB--override-arch\fP options documented in skopeo(1).

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

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

.PP
Path of the primary 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--cert-dir\fP \fIpath\fP

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

.PP
\fB--config\fP

.PP
Output configuration in OCI format, default is to format in JSON format.

.PP
\fB--creds\fP \fIusername[:password]\fP

.PP
Username and password for accessing the registry.

.PP
\fB--daemon-host\fP \fIhost\fP

.PP
Use docker daemon host at \fIhost\fP (\fBdocker-daemon:\fR transport only)

.PP
\fB--format\fP, \fB-f\fP=\fIformat\fP

.PP
Format the output using the given Go template.
The keys of the returned JSON can be used as the values for the --format flag (see examples below).
Supports the Go templating functions available at https://pkg.go.dev/github.com/containers/common/pkg/report#hdr-Template_Functions

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

.PP
Print usage statement

.PP
\fB--no-creds\fP

.PP
Access the registry anonymously.

.PP
\fB--raw\fP

.PP
Output raw manifest or config data depending on --config option.
The --format option is not supported with --raw option.

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

.PP
Registry 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--shared-blob-dir\fP \fIdirectory\fP

.PP
Directory to use to share blobs across OCI repositories.

.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.

.PP
\fB--no-tags\fP, \fB-n\fP

.PP
Do not list the available tags from the repository in the output. When \fBtrue\fR, the \fBRepoTags\fR array will be empty.  Defaults to \fBfalse\fR, which includes all available tags.

.PP
\fB--manifest-digest\fP=\fIalgorithm\fP \fBEXPERIMENTAL\fP

.PP
Algorithm to use for computing manifest digest (sha256, sha512); defaults to algorithm used in config digest.

.PP
\fBNote:\fP This flag is experimental and its behavior may change in future releases.

.SH EXAMPLES
To review information for the image fedora from the docker.io registry:

.EX
$ skopeo inspect docker://docker.io/fedora

{
    "Name": "docker.io/library/fedora",
    "Digest": "sha256:f99efcddc4dd6736d8a88cc1ab6722098ec1d77dbf7aed9a7a514fc997ca08e0",
    "RepoTags": [
        "20",
        "21",
        "..."
    ],
    "Created": "2022-11-16T07:26:42.618327645Z",
    "DockerVersion": "20.10.12",
    "Labels": {
        "maintainer": "Clement Verna \\u003ccverna@fedoraproject.org\\u003e"
    },
    "Architecture": "amd64",
    "Os": "linux",
    "Layers": [
        "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93"
    ],
    "LayersData": [
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93",
            "Size": 65990920,
            "Annotations": null
        }
    ],
    "Env": [
        "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
        "DISTTAG=f37container",
        "FGC=f37",
        "FBR=f37"
    ]
}
.EE

.PP
To inspect python from the docker.io registry and not show the available tags:

.EX
$ skopeo inspect --no-tags docker://docker.io/library/python
{
    "Name": "docker.io/library/python",
    "Digest": "sha256:10fc14aa6ae69f69e4c953cffd9b0964843d8c163950491d2138af891377bc1d",
    "RepoTags": [],
    "Created": "2022-11-16T06:55:28.566254104Z",
    "DockerVersion": "20.10.12",
    "Labels": null,
    "Architecture": "amd64",
    "Os": "linux",
    "Layers": [
        "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
        "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
        "..."
    ],
    "LayersData": [
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
            "Size": 55038615,
            "Annotations": null
        },
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
            "Size": 5164893,
            "Annotations": null
        },
        "..."
    ],
    "Env": [
        "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
        "LANG=C.UTF-8",
        "...",
    ]
}
.EE

.EX
$ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
amd64
.EE

.EX
$ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]
.EE

.PP
To get the digest using a specific algorithm:

.EX
$ skopeo inspect --manifest-digest=sha512 docker://docker.io/library/alpine:latest --format "Digest: {{.Digest}}"
Digest: sha512:5acb33fb56a7791bf0c69d5b19a1c70272148e4107be5261d57305d14e9509792bbca53e5277c456181ecfa1c20ad8427f9b8ba46868020584a819de1128dbd2
.EE

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

.SH AUTHORS
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]