0a0dd116 |
% DOCKER(1) Docker User Manuals |
b07f1938 |
% Docker Community
% JUNE 2014 |
0a0dd116 |
# NAME |
b6d55ebc |
docker-login - Register or log in to a Docker registry. |
0a0dd116 |
# SYNOPSIS |
b07f1938 |
**docker login**
[**-e**|**--email**[=*EMAIL*]] |
a2b529ea |
[**--help**] |
b07f1938 |
[**-p**|**--password**[=*PASSWORD*]]
[**-u**|**--username**[=*USERNAME*]] |
e01baa6b |
[SERVER] |
0a0dd116 |
# DESCRIPTION |
7b2b7df3 |
Register or log in to a Docker Registry located on the specified |
b6d55ebc |
`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. |
0a0dd116 |
|
b6d55ebc |
You can log into any public or private repository for which you have
credentials. When you log in, the command stores encoded credentials in |
6827782b |
`$HOME/.docker/config.json` on Linux or `%USERPROFILE%/.docker/config.json` on Windows. |
ed0d2ac3 |
|
0a0dd116 |
# OPTIONS
**-e**, **--email**="" |
b07f1938 |
Email |
0a0dd116 |
|
a2b529ea |
**--help**
Print usage statement
|
0a0dd116 |
**-p**, **--password**=""
Password
**-u**, **--username**=""
Username
|
b07f1938 |
# EXAMPLES |
0a0dd116 |
|
b6d55ebc |
## Login to a registry on your localhost |
0a0dd116 |
# docker login localhost:8080
|
41dc0e08 |
# See also
**docker-logout(1)** to log out from a Docker registry.
|
0a0dd116 |
# HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com) |
fa29b1f0 |
based on docker.com source material and internal work. |
b07f1938 |
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |
b6d55ebc |
April 2015, updated by Mary Anthony for v2 <mary@docker.com> |