2016-02-29 20:51:36 -05:00
Log in to a Docker Registry located on the specified
2015-06-08 13:48:20 -04:00
`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.
2016-02-29 20:51:36 -05:00
`docker login` requires user to use `sudo` or be `root` , except when:
2015-11-02 17:20:38 -05:00
1. connecting to a remote daemon, such as a `docker-machine` provisioned `docker engine` .
2017-01-09 07:14:48 -05:00
2. 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 ](https://docs.docker.com/engine/security/security/#/docker-daemon-attack-surface ) for details.
2015-11-02 17:20:38 -05:00
2015-06-08 13:48:20 -04:00
You can log into any public or private repository for which you have
credentials. When you log in, the command stores encoded credentials in
2015-07-10 14:49:57 -04:00
`$HOME/.docker/config.json` on Linux or `%USERPROFILE%/.docker/config.json` on Windows.
2015-06-08 13:48:20 -04:00
# EXAMPLES
## Login to a registry on your localhost
# docker login localhost:8080
# See also
**docker-logout(1)** to log out from a Docker registry.