1skopeo-login(1)()                                            skopeo-login(1)()
2
3
4

NAME

6       skopeo-login - Login to a container registry.
7
8

SYNOPSIS

10       skopeo login [options] registry
11
12

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

SEE ALSO

124       skopeo(1),  skopeo-logout(1),  containers-auth.json(5), containers-reg‐
125       istries.conf(5), containers-certs.d.5.md
126
127

HISTORY

129       May   2020,   Originally   compiled   by   Qi   Wang   qiwan@redhat.com
130       ⟨mailto:qiwan@redhat.com⟩
131
132
133
134                                                             skopeo-login(1)()
Impressum