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 '[]' 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 docker-machine provisioned docker engine.


user is added to the docker group.  This will impact the security of your system; the docker group is root equivalent.  See 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

See also

docker-logout(1) to log out from a Docker registry.


April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on source material and internal work. June 2014, updated by Sven Dowideit  ⟨⟩ April 2015, updated by Mary Anthony for v2  ⟨⟩ November 2015, updated by Sally O'Malley  ⟨⟩ March 2018, updated by Tom Sweeney  ⟨⟩

Referenced By

buildah-bud(1), buildah-from(1), buildah-push(1), docker(1), docker-logout(1), docker-pull(1), docker-push(1), skopeo(1).

Docker User Manuals Docker Community JUNE 2014