.nh
.TH skopeo-login(1)
.SH NAME
skopeo-login \- Login to a container registry.

.SH SYNOPSIS
\fBskopeo login\fP [\fIoptions\fP] \fIregistry\fP

.SH DESCRIPTION
\fBskopeo login\fP logs into a specified registry server with the correct username
and password. \fBskopeo login\fP reads in the username and password from STDIN.
The username and password can also be set using the \fBusername\fP and \fBpassword\fP flags.
The path of the credentials file can be specified by the user by setting the \fBauthfile\fP
flag.

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

.PP
\fB--password\fP, \fB-p\fP=\fIpassword\fP

.PP
Password for registry

.PP
\fB--password-stdin\fP

.PP
Take the password from stdin

.PP
\fB--username\fP, \fB-u\fP=\fIusername\fP

.PP
Username for registry

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

.PP
Path of the managed 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 default on other platforms.

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

.PP
\fB--compat-auth-file\fP=\fIpath\fP

.PP
Instead of updating the default credentials file, update the one at \fIpath\fP, and use a Docker-compatible format.

.PP
\fB--get-login\fP

.PP
Return the logged-in user for the registry. Return error if no login is found.

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

.PP
Use certificates at \fIpath\fP (*\&.crt, *\&.cert, *\&.key) to connect to the registry.
Default certificates directory is \fI/etc/containers/certs.d\fP\&.

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

.PP
Print usage statement

.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--verbose\fP, \fB-v\fP

.PP
Write more detailed information to stdout

.SH EXAMPLES
.EX
$ skopeo login docker.io
Username: testuser
Password:
Login Succeeded!
.EE

.EX
$ skopeo login -u testuser -p testpassword localhost:5000
Login Succeeded!
.EE

.EX
$ skopeo login --authfile authdir/myauths.json docker.io
Username: testuser
Password:
Login Succeeded!
.EE

.EX
$ skopeo login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
.EE

.EX
$ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!
.EE

.EX
$ skopeo login -u testuser  --password-stdin < testpassword.txt docker.io
Login Succeeded!
.EE

.EX
$ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
Login Succeeded!
.EE

.SH SEE ALSO
skopeo(1), skopeo-logout(1), containers-auth.json(5), containers-registries.conf(5), containers-certs.d.5.md

.SH HISTORY
May 2020, Originally compiled by Qi Wang qiwan@redhat.com
\[la]mailto:qiwan@redhat.com\[ra]