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.

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

1

Obtain an API token

Generate an API token for registry authentication through the Valyent console.

2

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:

docker login registry.valyent.cloud \
    -u <your-username> \
    -p <your-api-token>

​
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 SlugApplication NameTag
manhattan-projectfastapi-webapplatest
docker push registry.valyent.cloud/manhattan-project/fastapi-webapp:latest
CLI-based deploymentsGo