skopeo-login - Man Page

Login to a container registry.

Synopsis

skopeo login [options] registry

Description

skopeo login logs into a specified registry server with the correct username and password. skopeo login reads in the username and password from STDIN. The username and password can also be set using the username and password flags. The path of the authentication file can be specified by the user by setting the authfile flag. The default path used is ${XDG_RUNTIME_DIR}/containers/auth.json.

Options

--password,  -p=password
Password for registry
--password-stdin
Take the password from stdin
--username,  -u=username
Username for registry
--authfile=path
Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/containers/auth.json

Note: You can also override the default path of the authentication file by setting the REGISTRY_AUTH_FILE environment variable. export REGISTRY_AUTH_FILE=path

--get-login
Return the logged-in user for the registry. Return error if no login is found.
--cert-dir=path
Use certificates at path (*.crt, *.cert, *.key) to connect to the registry. Default certificates directory is /etc/containers/certs.d.
--tls-verify=true|false
Require HTTPS and verify certificates when contacting registries (default: true). If explicitly set to true, then TLS verification will be used. If set to false, then TLS verification will not be used. If not specified, TLS verification will be used unless the target registry is listed as an insecure registry in registries.conf.
--help,  -h
Print usage statement

Examples

$ skopeo login docker.io
Username: testuser
Password:
Login Succeeded!
$ skopeo login -u testuser -p testpassword localhost:5000
Login Succeeded!
$ skopeo login --authfile authdir/myauths.json docker.io
Username: testuser
Password:
Login Succeeded!
$ skopeo login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
$ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!
$ skopeo login -u testuser  --password-stdin < testpassword.txt docker.io
Login Succeeded!
$ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
Login Succeeded!

See Also

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

History

May 2020, Originally compiled by Qi Wang qiwan@redhat.com ⟨mailto:qiwan@redhat.com⟩

Referenced By

containers-auth.json(5), skopeo(1), skopeo-copy(1), skopeo-delete(1), skopeo-inspect(1), skopeo-list-tags(1), skopeo-logout(1), skopeo-sync(1).