docker-latest-login (1) - Linux Manuals

docker-latest-login: Log in to a Docker registry.


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 Docker's public registry located at by default. 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:

item connecting to a remote daemon, such as a docker-machine provisioned docker engine. item user is added to the docker group. This will impact the security of your system; the docker group is root equivalent. See <> 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


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 <SvenDowideit [at]> April 2015, updated by Mary Anthony for v2 <mary [at]> November 2015, updated by Sally O'Malley <somalley [at]>

See also

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