Terraform

Manage Verda infrastructure using Terraform, including compute, storage, and container resources.

Terraform allows you to manage Verda infrastructure declaratively using infrastructure as code. With the Verda Terraform provider, you can provision and maintain GPU compute instances, storage volumes, and container workloads in a reproducible and version-controlled way.

This section documents how to use Terraform to interact with Verda Cloud resources.

---

Quickstart

Add the Verda provider to your Terraform configuration:

terraform {
  required_providers {
    verda = {
      source  = "verda-cloud/verda"
      version = "~> 1.0"
    }
  }
}

provider "verda" {}

Authentication is handled via environment variables:

export VERDA_CLIENT_ID="your-client-id"
export VERDA_CLIENT_SECRET="your-client-secret"

Once configured, you can start defining Verda resources such as compute instances, volumes, and containers.

---

What you can manage with Terraform

Using the Verda provider, you can manage:

• Compute

  • GPU instances

  • SSH keys for instance access

  • Startup scripts for automated provisioning

• Storage

  • Persistent NVMe volumes

  • Volume attachment to instances

• Containers

  • Serverless container deployments

  • Serverless batch jobs

  • Private container registry credentials

• Lifecycle operations

  • Create, update, and destroy resources

  • Import existing Verda resources into Terraform state

---

Documentation structure

The Terraform documentation is organized by resource type:

• Getting Started – Installing Terraform and verifying access

• Authentication – How Terraform authenticates with Verda

• Provider Configuration – Provider settings and options

• Compute – Instances, SSH keys, and startup scripts

• Storage – Persistent volumes

• Containers – Containers, serverless jobs, and registry credentials

• Importing Existing Resources – Bringing existing infrastructure under Terraform management

Use the navigation sidebar to jump directly to the resource you want to manage.

---

Terraform and OpenTofu compatibility

The Verda provider is compatible with both Terraform and OpenTofu. If you are using OpenTofu, see the OpenTofu section for registry configuration and migration notes.