DOCKER

Section: Docker User Manuals (1)
Updated: Jun 2025
Index Return to Main Contents

---

 

NAME

docke-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://registr-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 docke-machine provisioned 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 [la]https://docs.docker.com/engine/security/#docker-daemon-attack-surface[ra] 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/config.json on Windows.

 

EXAMPLES

 

Login to a registry on your localhost

# docker login localhost:8080

 

See also

docke-logout(1) to log out from a registry.

 

OPTIONS

-p, -password=""         Password or Personal Access Token (PAT)

-passwor-stdin[=false]         Take the Password or Personal Access Token (PAT) from stdin

-u, -username=""         Username

 

SEE ALSO

docker(1)

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

EXAMPLES

Login to a registry on your localhost

See also

OPTIONS

SEE ALSO