---
title: Provisioning
url: https://docs.vultr.com/products/orchestration/container-registry/provisioning
description: The process of setting up and configuring a new server or service to make it ready for use.
publish_date: 2024-09-23T20:21:24.478638Z
last_updated: 2026-05-26T20:19:20.523498Z
---

# How to Provision Vultr Container Registry

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 Console, API, CLI, or Terraform.

=== "Vultr Console"

    1. Navigate to **Products** and click **Container Registry**.

    1. Click **Add Container Registry**.

    1. Provide a **Registry Name**.

    1. Choose a **Container Registry Location**.

    1. Pick a suitable **Plan**.

    1. By default, the visibility is set to private. Select the checkbox to set the visibility to public.

    1. Click **Add Container Registry**.

=== "Vultr API"

    1. Send a `GET` request to the [**List Registry Regions** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-regions) 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}"
        ```

    1. Send a `GET` request to the [**List Registry Plans** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-plans) 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}"
        ```

    1. Send a `POST` request to the [**Create Container Registry** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/create-registry) 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}"
            }'
        ```

    1. Send a `GET` request to the [**List Container Registries** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registries) to list all the available registries.

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

=== "Vultr CLI"

    1. List all Vultr Container Registry regions and note your target region name (e.g., `ewr`, `sjp`, `blr`).

        ```console
        $ vultr-cli container-registry regions
        ```

    1. List all Vultr Container Registry plans and note your target plan (e.g., `start_up`, `business`, `premium`, `enterprise`).

        ```console
        $ vultr-cli container-registry plans
        ```

    1. 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>"
        ```

    1. List all the available Vultr Container Registry subscriptions.

        ```console
        $ vultr-cli container-registry list
        ```

=== "Terraform"

    1. Ensure the [Vultr Terraform provider](https://registry.terraform.io/providers/vultr/vultr/latest/docs) is configured in your Terraform project.

    1. Define the Container Registry resource in your Terraform configuration file.

        ```terraform
        terraform {
            required_providers {
                vultr = {
                    source  = "vultr/vultr"
                    version = "~> 2.27"
                }
            }
        }

        provider "vultr" {}

        resource "vultr_container_registry" "registry" {
          name   = "container-registry"    # Registry name
          region = "sjc"                   # Registry region (e.g., ewr, sjc, blr)
          plan   = "start_up"              # Plan key (start_up, business, premium, enterprise)
          public = false                   # Visibility (false=private, true=public)
        }
        ```

    1. Apply the configuration and observe the following output:

        ```
        Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
        ```