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

EXAMPLES

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

SEE ALSO

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

HISTORY

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