2018-08-30 08:41:19 +00:00
|
|
|
% podman-login(1)
|
2017-11-01 15:24:59 +00:00
|
|
|
|
|
|
|
## NAME
|
2018-04-26 13:21:11 +00:00
|
|
|
podman\-login - Login to a container registry
|
2017-11-01 15:24:59 +00:00
|
|
|
|
|
|
|
## SYNOPSIS
|
2018-06-29 17:53:33 +00:00
|
|
|
**podman login** [*options*] *registry*
|
2017-11-01 15:24:59 +00:00
|
|
|
|
|
|
|
## DESCRIPTION
|
2017-12-15 21:58:36 +00:00
|
|
|
**podman login** logs into a specified registry server with the correct username
|
|
|
|
and password. **podman login** reads in the username and password from STDIN.
|
2017-11-01 15:24:59 +00:00
|
|
|
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**.
|
|
|
|
|
2017-12-15 21:58:36 +00:00
|
|
|
**podman [GLOBAL OPTIONS]**
|
2017-11-01 15:24:59 +00:00
|
|
|
|
2017-12-15 21:58:36 +00:00
|
|
|
**podman login [GLOBAL OPTIONS]**
|
2017-11-01 15:24:59 +00:00
|
|
|
|
2017-12-15 21:58:36 +00:00
|
|
|
**podman login [OPTIONS] REGISTRY [GLOBAL OPTIONS]**
|
2017-11-01 15:24:59 +00:00
|
|
|
|
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
**--password, -p**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-01 15:24:59 +00:00
|
|
|
Password for registry
|
|
|
|
|
|
|
|
**--username, -u**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-01 15:24:59 +00:00
|
|
|
Username for registry
|
|
|
|
|
|
|
|
**--authfile**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-01 15:24:59 +00:00
|
|
|
Path of the authentication file. Default is ${XDG_\RUNTIME\_DIR}/containers/auth.json
|
|
|
|
|
2018-08-21 13:34:51 +00:00
|
|
|
**--cert-dir** *path*
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2018-08-21 13:34:51 +00:00
|
|
|
Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry.
|
2018-02-06 22:10:10 +00:00
|
|
|
Default certificates directory is _/etc/containers/certs.d_.
|
2017-11-27 09:38:21 +00:00
|
|
|
|
|
|
|
**--tls-verify**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-27 09:38:21 +00:00
|
|
|
Require HTTPS and verify certificates when contacting registries (default: true)
|
|
|
|
|
2018-06-29 17:53:33 +00:00
|
|
|
**--help**, **-h**
|
|
|
|
|
|
|
|
Print usage statement
|
|
|
|
|
2017-11-01 15:24:59 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
|
|
|
```
|
2018-08-30 11:05:37 +00:00
|
|
|
$ podman login docker.io
|
2017-11-01 15:24:59 +00:00
|
|
|
Username: umohnani
|
|
|
|
Password:
|
|
|
|
Login Succeeded!
|
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2018-08-30 11:05:37 +00:00
|
|
|
$ podman login -u testuser -p testpassword localhost:5000
|
2017-11-01 15:24:59 +00:00
|
|
|
Login Succeeded!
|
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2018-08-30 11:05:37 +00:00
|
|
|
$ podman login --authfile authdir/myauths.json docker.io
|
2017-11-01 15:24:59 +00:00
|
|
|
Username: umohnani
|
|
|
|
Password:
|
|
|
|
Login Succeeded!
|
|
|
|
```
|
|
|
|
|
2017-11-27 09:38:21 +00:00
|
|
|
```
|
2018-01-04 20:21:32 +00:00
|
|
|
$ podman login --tls-verify=false -u test -p test localhost:5000
|
2017-11-27 09:38:21 +00:00
|
|
|
Login Succeeded!
|
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2018-01-04 20:21:32 +00:00
|
|
|
$ podman login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
|
2017-11-27 09:38:21 +00:00
|
|
|
Login Succeeded!
|
|
|
|
```
|
|
|
|
|
2017-11-01 15:24:59 +00:00
|
|
|
## SEE ALSO
|
2018-03-12 14:00:14 +00:00
|
|
|
podman(1), podman-logout(1), crio(8)
|
2017-11-01 15:24:59 +00:00
|
|
|
|
|
|
|
## HISTORY
|
|
|
|
August 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|