---
title: vultr_container_registry
url: https://docs.vultr.com/reference/terraform/resources/container_registry
description: A resource for creating and managing private container registries on the Vultr platform to store and distribute container images
publish_date: 2025-09-15T13:30:45.010522Z
last_updated: 2025-09-15T14:14:26.721153Z
---

# vultr_container_registry

Create and update a Vultr container registry.

## Example Usage

Create a new container registry:

```hcl
resource "vultr_container_registry" "vcr1" {
  name = "examplecontainerregistry"
  region = "sjc"
  plan = "start_up"
  public = false
}
```

The `name` for container registries must be all lowercase and only contain alphanumeric characters.

## Argument Reference

The follow arguments are supported:

* `name` - (Required) The name for your container registry.  Must be lowercase and only alphanumeric characters.
* `region` - (Required) The region where your container registry will be deployed. [See available regions](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-regions)
* `plan` - (Required) The billing plan for the container registry. [See available plans](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-plans)
* `public` - (Required) Boolean indicating if the container registry should be created with public visibility or if it should require credentials.

## Attributes Reference

The following attributes are exported:
* `id` - The container registry ID.
* `name` - The name of the container registry.
* `plan` - The container registry plan.
* `region` - The region in which the container registry is deployed.
* `public` - Boolean indicating whether or not the requires login credentials.
* `urn` - The URN of the container registry.
* `storage` - A listing of current storage usage relevant to the container registry.
* `root_user` - The user associated with the container registry.
* `date_created` - A date-time denoting when the container registry was created.

`storage`

* `used` - Amount of storage space used in gigabytes.
* `allowed` - Amount of storage space available in gigabytes.

`root_user`

* `id` - The ID of the root user.
* `username` - The username used to login as the root user.
* `password` - The password used to login as the root user.
* `date_created` - A date-time of when the root user was created.
* `date_modified` - A date-time of when the root user was last modified.