github.com/justincormack/cli@v0.0.0-20201215022714-831ebeae9675/man/src/login.md (about)

     1  Log in to a Docker Registry located on the specified
     2  `SERVER`.  You can specify a URL or a `hostname` for the `SERVER` value. If you
     3  do not specify a `SERVER`, the command uses Docker's public registry located at
     4  `https://registry-1.docker.io/` by default.  To get a username/password for Docker's public registry, create an account on Docker Hub.
     5  
     6  `docker login` requires user to use `sudo` or be `root`, except when:
     7  
     8  1.  connecting to  a remote daemon, such as a `docker-machine` provisioned `docker engine`.
     9  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/#docker-daemon-attack-surface) for details.
    10  
    11  You can log into any public or private repository for which you have
    12  credentials.  When you log in, the command stores encoded credentials in
    13  `$HOME/.docker/config.json` on Linux or `%USERPROFILE%/.docker/config.json` on Windows.
    14  
    15  # EXAMPLES
    16  
    17  ## Login to a registry on your localhost
    18  
    19      # docker login localhost:8080
    20  
    21  # See also
    22  **docker-logout(1)** to log out from a Docker registry.