---
name: "skopeo-login"
section: "1"
platform: "linux"
package: "skopeo"
version: "1.24.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/skopeo-login"
---

# skopeo-login(1)

Login to a container registry.

## NAME

skopeo-login - Login to a container registry.

## SYNOPSIS

**skopeo login** \[*options*\] *registry*

## DESCRIPTION

**skopeo login** logs into a specified registry server with the correct username and password. **skopeo login** reads in the username and password from STDIN. The username and password can also be set using the **username** and **password** flags. The path of the credentials file can be specified by the user by setting the **authfile** flag.

## OPTIONS

See also [skopeo(1)](/skopeo/1.md) for options placed before the subcommand name.

**--password**, **-p**=*password*

Password for registry

**--password-stdin**

Take the password from stdin

**--username**, **-u**=*username*

Username for registry

**--authfile**=*path*

Path of the managed registry credentials file. On Linux, the default is ${XDG\_RUNTIME\_DIR}/containers/auth.json. See [**containers-auth.json**(5)](/containers-auth.json/5.md) for more details about the default on other platforms.

The default value of this option is read from the **REGISTRY\\\_AUTH\\\_FILE** environment variable.

**--compat-auth-file**=*path*

Instead of updating the default credentials file, update the one at *path*, and use a Docker-compatible format.

**--get-login**

Return the logged-in user for the registry. Return error if no login is found.

**--cert-dir**=*path*

Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry. Default certificates directory is */etc/containers/certs.d*.

**--help**, **-h**

Print usage statement

**--tls-verify**=*bool*

Require HTTPS and verify certificates when talking to the container registry or daemon. Default to registry.conf setting.

**--verbose**, **-v**

Write more detailed information to stdout

## EXAMPLES

```
$ skopeo login docker.io
Username: testuser
Password:
Login Succeeded!
```

```
$ skopeo login -u testuser -p testpassword localhost:5000
Login Succeeded!
```

```
$ skopeo login --authfile authdir/myauths.json docker.io
Username: testuser
Password:
Login Succeeded!
```

```
$ skopeo login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
```

```
$ skopeo login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!
```

```
$ skopeo login -u testuser  --password-stdin < testpassword.txt docker.io
Login Succeeded!
```

```
$ echo $testpassword | skopeo login -u testuser --password-stdin docker.io
Login Succeeded!
```

## SEE ALSO

[skopeo(1)](/skopeo/1.md), [skopeo-logout(1)](/skopeo-logout/1.md), [containers-auth.json(5)](/containers-auth.json/5.md), [containers-registries.conf(5)](/containers-registries.conf/5.md), containers-certs.d.5.md

## HISTORY

May 2020, Originally compiled by Qi Wang qiwan@redhat.com ⟨mailto:qiwan@redhat.com⟩