> ## Documentation Index
> Fetch the complete documentation index at: https://runpod-b18f5ded-promptless-runpodctl-registry-password-stdin.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# registry

Manage container registry authentications for private Docker images.

<RequestExample>
  ```bash Command theme={"theme":{"light":"github-light","dark":"github-dark"}}
  runpodctl registry <subcommand> [flags]
  ```
</RequestExample>

## Alias

You can use `reg` as a shorthand for `registry`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl reg list
```

## Subcommands

### List registry authentications

List all your container registry authentications:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry list
```

### Get registry authentication details

Get details about a specific registry authentication:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry get <registry-id>
```

### Create a registry authentication

Create credentials for a private container registry. Supply the password in one of three ways:

* Pass it directly with the `--password` flag.
* Pipe or redirect it into `--password-stdin`.
* Omit both flags to enter it at an interactive prompt.

Pass the password directly with `--password`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry create --name "docker-hub" --username "myuser" --password "mypassword"
```

Omit the password flag to have the command prompt for the password without echoing it:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry create --name "docker-hub" --username "myuser"
```

Pipe a token held in an environment variable into `--password-stdin`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
printenv REGISTRY_TOKEN | runpodctl registry create --name "docker-hub" --username "myuser" --password-stdin
```

Redirect a token from a file into `--password-stdin`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry create --name "docker-hub" --username "myuser" --password-stdin < token.txt
```

For Google Artifact Registry or gcr.io, set `--username` to the literal `_json_key` and feed the multi-line service-account JSON key file through `--password-stdin`. The command supports multi-line passwords and strips only a single trailing newline added by the pipe or redirection.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry create --name "gcr" --username "_json_key" --password-stdin < service-account.json
```

<Tip>
  Prefer `--password-stdin` or the interactive prompt over `--password`. A value passed to `--password` is visible in the process table and your shell history.
</Tip>

#### Create flags

<ResponseField name="--name" type="string" required>
  Name for this registry authentication.
</ResponseField>

<ResponseField name="--username" type="string" required>
  Registry username.
</ResponseField>

<ResponseField name="--password" type="string">
  Registry password or access token. Cannot be used with `--password-stdin`. If neither `--password` nor `--password-stdin` is given, the command prompts for the password when run in an interactive terminal, or exits with an error otherwise.
</ResponseField>

<ResponseField name="--password-stdin" type="bool">
  Read the registry password from standard input (pipe, heredoc, or file redirection). Supports multi-line values. Cannot be used with `--password`.
</ResponseField>

### Delete a registry authentication

Delete a registry authentication:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
runpodctl registry delete <registry-id>
```

## Related commands

* [`runpodctl template create`](/runpodctl/reference/runpodctl-template)
* [`runpodctl pod create`](/runpodctl/reference/runpodctl-pod)