docker-login man page
docker-login — Log in to a Docker registry.
docker login [--help] [-p|--password[=PASSWORD]] [-u|--username[=USERNAME]] [SERVER]
Log in to a Docker Registry located on the specified
SERVER. You can specify a URL or a
hostname for the
SERVER value. If you do not specify a
SERVER, the command uses the first value in the field 'registries' in the '[registries.search]' table in /etc/containers/registries.conf, and if not specified there, Docker's public registry located at
To get a username/password for Docker's public registry, create an account on Docker Hub.
docker login requires user to use
sudo or be
root, except when:
connecting to a remote daemon, such as a
user is added to the
dockergroup. This will impact the security of your system; the
rootequivalent. See Docker Daemon Attack Surface ⟨https://docs.docker.com/engine/articles/security/#docker-daemon-attack-surface⟩ for details.
You can log into any public or private repository for which you have credentials. When you log in, the command stores encoded credentials in
$HOME/.docker/config.json on Linux or
%USERPROFILE%/.docker/config.json on Windows.
Print usage statement
- -p, --password=""
- -u, --username=""
Login to a registry on your localhost
# docker login localhost:8080
Login to Docker Hub overriding /etc/containers/registries.conf
# docker login docker.io
docker-logout(1) to log out from a Docker registry.
April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩ April 2015, updated by Mary Anthony for v2 ⟨firstname.lastname@example.org⟩ November 2015, updated by Sally O'Malley ⟨email@example.com⟩ March 2018, updated by Tom Sweeney ⟨firstname.lastname@example.org⟩
buildah-bud(1), buildah-from(1), buildah-push(1), docker(1), docker-logout(1), docker-pull(1), docker-push(1), skopeo(1).