% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014
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 https://registry-1.docker.io/
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:
docker-machine
provisioned docker engine
.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.
--help Print usage statement
-p, --password="" Password
-u, --username="" Username
# docker login localhost:8080
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 mary@docker.com November 2015, updated by Sally O'Malley somalley@redhat.com