> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valyent.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker Registry

> Learn how to use Valyent's Docker registry.

Valyent provides a secure Docker registry at `registry.valyent.cloud` for pushing and pulling container images to and from the Valyent Cloud platform.

The registry's source code is available as an open-source project on [GitHub](https://github.com/valyentdev/registry).

## Authentication

The `valyent auth login` command configures your local Docker client to authenticate with the Valyent Cloud platform, enabling image operations with the registry.

To authenticate without the Valyent CLI, follow these steps:

<Steps>
  <Step title="Obtain an API token">
    Generate an API token for registry authentication through the [Valyent console](https://console.valyent.cloud).
  </Step>

  <Step title="Configure Docker authentication">
    Use your API token as the password when logging in to the registry. You may use any username except `valyent`, which is reserved:

    ```bash theme={"system"}
    docker login registry.valyent.cloud \
        -u <your-username> \
        -p <your-api-token>
    ```
  </Step>
</Steps>

## Pushing Images

When pushing images to the Valyent Docker registry, use the following naming convention:

```
registry.valyent.cloud/<organization-slug>/<application-name>:<tag>
```

This naming structure is required for Valyent to properly deploy your applications.

Example:

| Organization Slug | Application Name | Tag    |
| ----------------- | ---------------- | ------ |
| manhattan-project | fastapi-webapp   | latest |

```bash theme={"system"}
docker push registry.valyent.cloud/manhattan-project/fastapi-webapp:latest
```