1skopeo-login(1)() skopeo-login(1)()
2
3
4
6 skopeo-login - Login to a container registry.
7
8
10 skopeo login [options] registry
11
12
14 skopeo login logs into a specified registry server with the correct
15 username and password. skopeo 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
23 --password, -p=password
24
25
26 Password for registry
27
28
29 --password-stdin
30
31
32 Take the password from stdin
33
34
35 --username, -u=username
36
37
38 Username for registry
39
40
41 --authfile=path
42
43
44 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
45 ers/auth.json
46
47
48 Note: You can also override the default path of the authentication file
49 by setting the REGISTRY_AUTH_FILE environment variable. export REG‐
50 ISTRY_AUTH_FILE=path
51
52
53 --get-login
54
55
56 Return the logged-in user for the registry. Return error if no login is
57 found.
58
59
60 --cert-dir=path
61
62
63 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
64 istry. Default certificates directory is /etc/containers/certs.d.
65
66
67 --tls-verify=true|false
68
69
70 Require HTTPS and verify certificates when contacting registries
71 (default: true). If explicitly set to true, then TLS verification will
72 be used. If set to false, then TLS verification will not be used. If
73 not specified, TLS verification will be used unless the target registry
74 is listed as an insecure registry in registries.conf.
75
76
77 --help, -h
78
79
80 Print usage statement
81
82
84 $ skopeo login docker.io
85 Username: testuser
86 Password:
87 Login Succeeded!
88
89
90
91 $ skopeo login -u testuser -p testpassword localhost:5000
92 Login Succeeded!
93
94
95
96 $ skopeo login --authfile authdir/myauths.json docker.io
97 Username: testuser
98 Password:
99 Login Succeeded!
100
101
102
103 $ skopeo login --tls-verify=false -u test -p test localhost:5000
104 Login Succeeded!
105
106
107
108 $ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
109 Login Succeeded!
110
111
112
113 $ skopeo login -u testuser --password-stdin < testpassword.txt docker.io
114 Login Succeeded!
115
116
117
118 $ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
119 Login Succeeded!
120
121
122
124 skopeo(1), skopeo-logout(1), containers-auth.json(5), containers-reg‐
125 istries.conf(5), containers-certs.d.5.md
126
127
129 May 2020, Originally compiled by Qi Wang qiwan@redhat.com
130 ⟨mailto:qiwan@redhat.com⟩
131
132
133
134 skopeo-login(1)()