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       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

EXAMPLES

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

SEE ALSO

131       skopeo(1),  skopeo-logout(1),  containers-auth.json(5), containers-reg‐
132       istries.conf(5), containers-certs.d.5.md
133
134

HISTORY

136       May 2020, Originally compiled by Qi Wang  qiwan@redhat.com  ⟨mailto:qi‐
137       wan@redhat.com⟩
138
139
140
141                                                             skopeo-login(1)()
Impressum