How to Provision Vultr Container Registry

Updated on September 23, 2024

Vultr Container Registry is a managed storage and distribution system for Open Container Initiative (OCI) images and related artifacts. This subscription allows you to securely host multiple container images, enabling you to build and deploy applications on platforms like Docker and Kubernetes. Vultr Container Registry simplifies the management of containerized applications, providing a reliable and scalable solution for your image storage needs.

Follow this guide to provision a Vultr Container Registry on your Vultr account using the Vultr Customer Portal, API, or CLI.

Vultr Customer Portal
Vultr API
Vultr CLI

Navigate to Products and click Container Registry.
Click Add Container Registry.
Provide a Registry Name.
Choose a Container Registry Location.
Pick a suitable Plan.
By default, the visibility is set to private. Select the checkbox to set the visibility to public.
Click Add Container Registry.

Send a GET request to the List Registry Regions endpoint and note your target region name (e.g., ewr, sjp, blr).

                            console
                            
                        
$ curl "https://api.vultr.com/v2/registry/region/list" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

Send a GET request to the List Registry Plans endpoint and note your target plan key (e.g., start_up, business, premium, enterprise).
console
```
$ curl "https://api.vultr.com/v2/registry/plan/list" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"
```

Send a POST request to the Create Container Registry endpoint to create a registry with your target region and plan.

                            console
                            
                        
$ curl "https://api.vultr.com/v2/registry" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    --data '{
        "name" : "{label}",
        "public" : false,
        "region" : "{region-name}",
        "plan" : "{plan-key}"
    }'

Send a GET request to the List Container Registries endpoint to list all the available registries.

                            console
                            
                        
$ curl "https://api.vultr.com/v2/registries" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

List all Vultr Container Registry regions and note your target region name (e.g., ewr, sjp, blr).
console
```
$ vultr-cli container-registry regions
```
List all Vultr Container Registry plans and note your target plan (e.g., start_up, business, premium, enterprise).
console
```
$ vultr-cli container-registry plans
```

Create a Vultr Container Registry with your target region and plan.

                            console
                            
$ vultr-cli container-registry create  --name "<label>"  --public false  --region "<region-name>"  --plan "<plan-key>"