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. If the registry is not specified, the first reg‐
16       istry under [registries.search] from registries.conf will be used. pod‐
17       man login reads in the username and password from STDIN.  The  username
18       and  password  can  also  be set using the username and password flags.
19       The path of the authentication file can be specified  by  the  user  by
20       setting  the  authfile  flag.  The  default  path  used  is  ${XDG_RUN‐
21       TIME_DIR}/containers/auth.json.
22
23
24       podman [GLOBAL OPTIONS]
25
26
27       podman login [GLOBAL OPTIONS]
28
29
30       podman login [OPTIONS] [REGISTRY] [GLOBAL OPTIONS]
31
32

OPTIONS

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

EXAMPLES

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

SEE ALSO

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

HISTORY

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