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 See also skopeo(1) for options placed before the subcommand name.
24
25
26 --password, -p=password
27
28
29 Password for registry
30
31
32 --password-stdin
33
34
35 Take the password from stdin
36
37
38 --username, -u=username
39
40
41 Username for registry
42
43
44 --authfile=path
45
46
47 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
48 ers/auth.json
49
50
51 Note: You can also override the default path of the authentication file
52 by setting the REGISTRY_AUTH_FILE environment variable. export REG‐
53 ISTRY_AUTH_FILE=path
54
55
56 --compat-auth-file=path
57
58
59 Instead of updating the default credentials file, update the one at
60 path, and use a Docker-compatible format.
61
62
63 --get-login
64
65
66 Return the logged-in user for the registry. Return error if no login is
67 found.
68
69
70 --cert-dir=path
71
72
73 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
74 istry. Default certificates directory is /etc/containers/certs.d.
75
76
77 --help, -h
78
79
80 Print usage statement
81
82
83 --tls-verify=bool
84
85
86 Require HTTPS and verify certificates when talking to the container
87 registry or daemon. Default to registry.conf setting.
88
89
90 --verbose, -v
91
92
93 Write more detailed information to stdout
94
95
97 $ skopeo login docker.io
98 Username: testuser
99 Password:
100 Login Succeeded!
101
102
103 $ skopeo login -u testuser -p testpassword localhost:5000
104 Login Succeeded!
105
106
107 $ skopeo login --authfile authdir/myauths.json docker.io
108 Username: testuser
109 Password:
110 Login Succeeded!
111
112
113 $ skopeo login --tls-verify=false -u test -p test localhost:5000
114 Login Succeeded!
115
116
117 $ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
118 Login Succeeded!
119
120
121 $ skopeo login -u testuser --password-stdin < testpassword.txt docker.io
122 Login Succeeded!
123
124
125 $ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
126 Login Succeeded!
127
128
129
131 skopeo(1), skopeo-logout(1), containers-auth.json(5), containers-reg‐
132 istries.conf(5), containers-certs.d.5.md
133
134
136 May 2020, Originally compiled by Qi Wang qiwan@redhat.com ⟨mailto:qi‐
137 wan@redhat.com⟩
138
139
140
141 skopeo-login(1)()