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       --help, -h
68
69
70       Print usage statement
71
72
73       --tls-verify=bool
74
75
76       Require  HTTPS  and  verify  certificates when talking to the container
77       registry or daemon. Default to registry.conf setting.
78
79
80       --verbose, -v
81
82
83       Write more detailed information to stdout
84
85

EXAMPLES

87              $ skopeo login docker.io
88              Username: testuser
89              Password:
90              Login Succeeded!
91
92
93
94              $ skopeo login -u testuser -p testpassword localhost:5000
95              Login Succeeded!
96
97
98
99              $ skopeo login --authfile authdir/myauths.json docker.io
100              Username: testuser
101              Password:
102              Login Succeeded!
103
104
105
106              $ skopeo login --tls-verify=false -u test -p test localhost:5000
107              Login Succeeded!
108
109
110
111              $ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
112              Login Succeeded!
113
114
115
116              $ skopeo login -u testuser  --password-stdin < testpassword.txt docker.io
117              Login Succeeded!
118
119
120
121              $ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
122              Login Succeeded!
123
124
125

SEE ALSO

127       skopeo(1), skopeo-logout(1),  containers-auth.json(5),  containers-reg‐
128       istries.conf(5), containers-certs.d.5.md
129
130

HISTORY

132       May  2020,  Originally compiled by Qi Wang qiwan@redhat.com ⟨mailto:qi‐
133       wan@redhat.com⟩
134
135
136
137                                                             skopeo-login(1)()