Vultr DocsLatest Content


How to Manage the Visibility of Vultr Container Registry

Updated on 15 September, 2025

Controls which users can view and access specific resources in your Vultr account.


Setting a Vultr Container Registry to Public allows broader access, making it easier to share and deploy container images across multiple environments and teams. By configuring your registry to be public, you facilitate wider distribution and collaboration on your containerized applications.

Follow this guide to set your container registry visibility to public on your Vultr account using the Vultr Customer Portal, API, CLI, or Terraform.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  • Terraform
  1. Navigate to Products and click Container Registry.

  2. Click your target registry to open its management page.

  3. Click Settings to open its settings page.

  4. In the Change Visibility section, check the Public box to set the visibility to public, or uncheck the box to set it to private.

  5. Click Update to apply the change.

  1. Send a GET request to the List Container Registries endpoint and note the target registry's ID.

    console
    $ curl "https://api.vultr.com/v2/registries" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  2. Send a PUT request to the Update Container Registry endpoint to update the target registry visibility.

    console
    $ curl "https://api.vultr.com/v2/registry/{registry-id}" \
        -X PUT \
        -H "Authorization: Bearer ${VULTR_API_KEY}" \
        -H "Content-Type: application/json" \
        --data '{
            "public" : true
        }'
    
  1. List all the available registries in your Vultr account and note the target registry's ID.

    console
    $ vultr-cli container-registry list
    
  2. Update the visibility of your target registry.

    console
    $ vultr-cli container-registry update <registry-id> --public true
    
  1. Open your Terraform configuration where the Container Registry is defined.

  2. Update the public attribute in your Container Registry resource to change the visibility.

    terraform
    terraform {
        required_providers {
            vultr = {
                source  = "vultr/vultr"
                version = "~> 2.27"
            }
        }
    }
    
    provider "vultr" {}
    
    resource "vultr_container_registry" "registry" {
      name   = "container-registry"
      region = "sjc"
      plan   = "start_up"
      public = true  # true=public, false=private
    }
    
  3. Apply the configuration and observe the following output:

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

Comments

No comments yet.