How to Create a Container Registry

You can create a new container registry using the control panel, API, or CLI. It requires a name, datacenter region, and subscription plan.

After creating a registry, you can configure it to push and pull from Docker and DigitalOcean Kubernetes.

Create a Container Registry Using the Control Panel

To create a container registry from the DigitalOcean Control Panel, in the left menu, click Container Registry. Then, click the Create a Container Registry button to go to the Create a container registry page.

Choose a Subscription Plan

Choose one of the following subscription plans:

• Starter: Free, to test out the product.

• Basic: Includes multiple repositories and 5 GiB storage.

• Professional: Includes unlimited repositories, and 100 GiB of storage.

For more details on the different plans, see the pricing page.

Choose a Datacenter Region

Use the drop-down menu to select your registry’s datacenter region. For the best performance, we recommend you select a region close to your other DigitalOcean resources.

Name Your Container Registry

Enter a custom name for your container registry. Names must be unique, be between 3 and 63 characters long, and only contain alphanumeric characters and dashes. You cannot change a registry’s name after creation.

Create Registry

Create the registry by clicking Create Registry.

Once your registry is created, the Repositories tab opens where you can view registry information such as stored images and monitor unused data.

Create a Container Registry Using the API

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"name": "example", "subscription_tier_slug": "basic", "region": "fra1"}' \
  "https://api.digitalocean.com/v2/registry"

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "name": "example",
  "subscription_tier_slug": "basic",
  "region": "fra1"
}

resp = client.registry.create(body=req)

Create a Container Registry Using the CLI