1podman-login(1)             General Commands Manual            podman-login(1)
2
3
4

NAME

6       podman-login - Login to a container registry
7
8

SYNOPSIS

10       podman login [options] registry
11
12

DESCRIPTION

14       podman login logs into a specified registry server with the correct
15       username and password. podman login reads in the username and password
16       from STDIN.  The username and password can also be set using the
17       username and password flags.  The path of the authentication file can
18       be specified by the user by setting the authfile flag. The default path
19       used is ${XDG_RUNTIME_DIR}/containers/auth.json.
20
21
22       podman [GLOBAL OPTIONS]
23
24
25       podman login [GLOBAL OPTIONS]
26
27
28       podman login [OPTIONS] REGISTRY [GLOBAL OPTIONS]
29
30

OPTIONS

32       --password, -p
33
34
35       Password for registry
36
37
38       --password-stdin
39
40
41       Take the password from stdin
42
43
44       --username, -u
45
46
47       Username for registry
48
49
50       --authfile
51
52
53       Path of the authentication file. Default is
54       ${XDG_\RUNTIME_DIR}/containers/auth.json (Not available for remote
55       commands)
56
57
58       Note: You can also override the default path of the authentication file
59       by setting the REGISTRY_AUTH_FILE environment variable. export
60       REGISTRY_AUTH_FILE=path
61
62
63       --get-login
64
65
66       Return the logged-in user for the registry.  Return error if no login
67       is found.
68
69
70       --cert-dir path
71
72
73       Use certificates at path (*.crt, *.cert, *.key) to connect to the
74       registry.  Default certificates directory is /etc/containers/certs.d.
75       (Not available for remote commands)
76
77
78       --tls-verify
79
80
81       Require HTTPS and verify certificates when contacting registries
82       (default: true). If explicitly set to true, then TLS verification will
83       be used. If set to false, then TLS verification will not be used. If
84       not specified, TLS verification will be used unless the target registry
85       is listed as an insecure registry in registries.conf. (Not available
86       for remote commands)
87
88
89       --help, -h
90
91
92       Print usage statement
93
94

EXAMPLES

96              $ podman login docker.io
97              Username: umohnani
98              Password:
99              Login Succeeded!
100
101
102
103              $ podman login -u testuser -p testpassword localhost:5000
104              Login Succeeded!
105
106
107
108              $ podman login --authfile authdir/myauths.json docker.io
109              Username: umohnani
110              Password:
111              Login Succeeded!
112
113
114
115              $ podman login --tls-verify=false -u test -p test localhost:5000
116              Login Succeeded!
117
118
119
120              $ podman login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
121              Login Succeeded!
122
123
124
125              $ podman login -u testuser  --password-stdin < testpassword.txt docker.io
126              Login Succeeded!
127
128
129
130              $ echo $testpassword | podman login -u testuser --password-stdin docker.io
131              Login Succeeded!
132
133
134

SEE ALSO

136       podman(1), podman-logout(1)
137
138

HISTORY

140       August 2017, Originally compiled by Urvashi Mohnani
141       ⟨umohnani@redhat.com⟩
142
143
144
145                                                               podman-login(1)