DOCKER(1) Docker User Manuals DOCKER(1)
NAME
docker-login - Authenticate to a registry
SYNOPSIS
docker login [OPTIONS] [SERVER]
DESCRIPTION
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:
1. connecting to a remote daemon, such as a docker-machine provi-
sioned docker engine.
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/secu-
rity/#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/con-
fig.json on Windows.
EXAMPLES
Login to a registry on your localhost
# docker login localhost:8080
See also
docker-logout(1) to log out from a registry.
OPTIONS
-p, --password="" Password or Personal Access Token (PAT)
--password-stdin[=false] Take the Password or Personal Access To-
ken (PAT) from stdin
-u, --username="" Username
SEE ALSO
docker(1)
Docker Community Apr 2026 DOCKER(1)
Generated by dwww version 1.14 on Sat Jun 13 09:43:10 CEST 2026.