docker-login(1)

docker-login1

Authenticate to a registry

Usage

docker login [OPTIONS] [SERVER]

Overview

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 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 ⟨https://docs.docker.com/engine/security/#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/config.json on Windows.

Examples

Login to a registry on your localhost

# docker login localhost:8080

Options

-p, --password=""
Password or Personal Access Token (PAT), or "-" to read from stdin

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

-u, --username=""
Username

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

From docker 1:29.9.2-1 in Arch Linux 2026-11-01. Also shipped by podman-docker. Parsed by carta from the page's man source.