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

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

.SH DESCRIPTION
.PP
Return low\-level information about \fIimage\-name\fP in a registry

.PP
\fIimage\-name\fP name of image to retrieve information about

.SH OPTIONS
.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\-\-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\-\-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).

.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; retry wait time will be exponentially increased based on the number of failed attempts.

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

.PP
Require HTTPS and verify certificates when talking to container registries (defaults to true).

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

.PP
.RS

.nf
$ skopeo inspect docker://docker.io/fedora
{
    "Name": "docker.io/library/fedora",
    "Digest": "sha256:a97914edb6ba15deb5c5acf87bd6bd5b6b0408c96f48a5cbd450b5b04509bb7d",
    "RepoTags": [
	"20",
	"21",
	"22",
	"23",
	"24",
	"heisenbug",
	"latest",
	"rawhide"
    ],
    "Created": "2016\-06\-20T19:33:43.220526898Z",
    "DockerVersion": "1.10.3",
    "Labels": {},
    "Architecture": "amd64",
    "Os": "linux",
    "Layers": [
	"sha256:7c91a140e7a1025c3bc3aace4c80c0d9933ac4ee24b8630a6b0b5d8b9ce6b9d4"
    ]
}

.fi
.RE

.PP
.RS

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

.fi
.RE

.PP
.RS

.nf
$ /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]

.fi
.RE


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