For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Provides a DigitalOcean NFS share which can be mounted to Droplets to provide shared storage.

Example Usage

resource "digitalocean_vpc" "example" {
  name   = "example-vpc"
  region = "nyc1"
}

resource "digitalocean_nfs" "example" {
  region           = "nyc1"
  name             = "example-nfs"
  size             = 50
  vpc_id           = digitalocean_vpc.example.id
  performance_tier = "high"
}

Example Usage - Multiple VPC Attachments

Attach an NFS share to additional VPCs one at a time using separate attachment resources:

resource "digitalocean_vpc" "primary" {
  name   = "primary-vpc"
  region = "nyc1"
}

resource "digitalocean_vpc" "secondary" {
  name   = "secondary-vpc"
  region = "nyc1"
}

resource "digitalocean_nfs" "example" {
  region           = "nyc1"
  name             = "example-nfs"
  size             = 50
  vpc_id           = digitalocean_vpc.primary.id
  performance_tier = "high"
}

resource "digitalocean_nfs_attachment" "primary" {
  share_id = digitalocean_nfs.example.id
  vpc_id   = digitalocean_vpc.primary.id
  region   = "nyc1"
}

resource "digitalocean_nfs_attachment" "secondary" {
  share_id = digitalocean_nfs.example.id
  vpc_id   = digitalocean_vpc.secondary.id
  region   = "nyc1"

  depends_on = [digitalocean_nfs_attachment.primary]
}

Argument Reference

The following arguments are supported:

• region - (Required) The region where the NFS share will be created.
• name - (Required) A name for the NFS share. Must be lowercase and composed only of numbers, letters, and “-”, up to a limit of 64 characters. The name must begin with a letter.
• size - (Required) The size of the NFS share in GiB. Minimum size is 50 GiB.
• vpc_id - (Required) The ID of the VPC where the NFS share will be created.
• performance_tier - (Optional) The performance tier for the NFS share. Can be standard or high. Defaults to high. Changing this will cause the performance tier to be switched.

Note: You cannot downgrade the performance tier from high to standard after creation. Upgrades from standard to high are allowed.

Attributes Reference

The following attributes are exported:

• id - The unique identifier for the NFS share.
• name - Name of the NFS share.
• region - The region where the NFS share is created.
• size - The size of the NFS share in GiB.
• performance_tier - The performance tier of the NFS share (standard or high).
• vpc_id - The ID of the primary VPC where the NFS share was created.
• vpc_ids - The set of VPC IDs the NFS share is attached to.
• status - The current status of the NFS share.
• created_at - The date and time when the NFS share was created.
• host - The host IP of the NFS server accessible from the associated VPC.
• mount_path - The mount path for accessing the NFS share.

Notes

An NFS share can be attached to multiple VPCs. Use one digitalocean_nfs_attachment resource per VPC. Multiple NFS shares can also be attached to the same VPC.

Import

NFS shares can be imported using the share id and the region, e.g.

terraform import digitalocean_nfs.foobar 506f78a4-e098-11e5-ad9f-000f53306ae1,atl1