github.com/ld86/docker@v1.7.1-rc3/man/docker-login.1.md (about) 1 % DOCKER(1) Docker User Manuals 2 % Docker Community 3 % JUNE 2014 4 # NAME 5 docker-login - Register or log in to a Docker registry. 6 7 # SYNOPSIS 8 **docker login** 9 [**-e**|**--email**[=*EMAIL*]] 10 [**--help**] 11 [**-p**|**--password**[=*PASSWORD*]] 12 [**-u**|**--username**[=*USERNAME*]] 13 [SERVER] 14 15 # DESCRIPTION 16 Register or log in to a Docker Registry located on the specified 17 `SERVER`. You can specify a URL or a `hostname` for the `SERVER` value. If you 18 do not specify a `SERVER`, the command uses Docker's public registry located at 19 `https://registry-1.docker.io/` by default. To get a username/password for Docker's public registry, create an account on Docker Hub. 20 21 You can log into any public or private repository for which you have 22 credentials. When you log in, the command stores encoded credentials in 23 `$HOME/.dockercfg` on Linux or `%USERPROFILE%/.dockercfg` on Windows. 24 25 # OPTIONS 26 **-e**, **--email**="" 27 Email 28 29 **--help** 30 Print usage statement 31 32 **-p**, **--password**="" 33 Password 34 35 **-u**, **--username**="" 36 Username 37 38 # EXAMPLES 39 40 ## Login to a registry on your localhost 41 42 # docker login localhost:8080 43 44 # See also 45 **docker-logout(1)** to log out from a Docker registry. 46 47 # HISTORY 48 April 2014, Originally compiled by William Henry (whenry at redhat dot com) 49 based on docker.com source material and internal work. 50 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 51 April 2015, updated by Mary Anthony for v2 <mary@docker.com>