podman/docs/podman-login.1.md
Daniel J Walsh 99d180efcc Modify man pages so they compile correctly in mandb
This fixes an issue where if you did
man -k podman-run

podman-run (1)    - (unknown subject)

Now you will see

man -k podman-run
podman-run (1)       - Run a command in a new container

More importantly

man -k containers | grep podman
podman (1)           - Simple management tool for containers and images
podman-kill (1)      - Kills one or more containers with a signal
podman-pause (1)     - Pause one or more containers
podman-ps (1)        - Prints out information about containers
podman-rm (1)        - Remove one or more containers
podman-start (1)     - Start one or more containers
podman-stats (1)     - Display a live stream of 1 or more containers' resource usage statistics
podman-stop (1)      - Stop one or more containers
podman-unpause (1)   - Unpause one or more containers
podman-wait (1)      - Waits on one or more containers to stop and prints exit code

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #676
Approved by: mheon
2018-04-26 13:46:14 +00:00

1.9 KiB

% podman(1) podman-login - Simple tool to login to a registry server % Urvashi Mohnani

podman-login "1" "August 2017" "podman"

NAME

podman-login - Login to a container registry

SYNOPSIS

podman login [--help|-h] [--authfile] [--user|-u] [--password|-p] REGISTRY

DESCRIPTION

podman login logs into a specified registry server with the correct username and password. podman login reads in the username and password from STDIN. The username and password can also be set using the username and password flags. The path of the authentication file can be specified by the user by setting the authfile flag. The default path used is ${XDG_RUNTIME_DIR}/containers/auth.json.

podman [GLOBAL OPTIONS]

podman login [GLOBAL OPTIONS]

podman login [OPTIONS] REGISTRY [GLOBAL OPTIONS]

OPTIONS

--password, -p Password for registry

--username, -u Username for registry

--authfile Path of the authentication file. Default is ${XDG_\RUNTIME_DIR}/containers/auth.json

--cert-dir Pathname of a directory containing TLS certificates and keys used to connect to the registry. Default certificates directory is /etc/containers/certs.d.

--tls-verify Require HTTPS and verify certificates when contacting registries (default: true)

EXAMPLES

# podman login docker.io
Username: umohnani
Password:
Login Succeeded!
# podman login -u testuser -p testpassword localhost:5000
Login Succeeded!
# podman login --authfile authdir/myauths.json docker.io
Username: umohnani
Password:
Login Succeeded!
$ podman login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
$ podman login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!

SEE ALSO

podman(1), podman-logout(1), crio(8)

HISTORY

August 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com