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).

To create and use a new Network File Storage (NFS) share, you need to create the share itself, and then mount it on a Droplet or DOKS cluster. NFS shares attach to one or more VPC networks in the same region, and can be mounted by Droplets and DOKS clusters in any of the share’s attached VPC networks. Create a VPC network for the NFS share in one of the supported datacenters before you begin.

Create a Share Using Automation

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"name": "sammy-share-drive", "size_gib": 1024, "region": "atl1", "vpc_ids": ["796c6fe3-2a1d-4da2-9f3e-38239827dc91"]}' \
  "https://api.digitalocean.com/v2/nfs"

Create a Share Using the Control Panel

To create a share from the control panel, click the Create menu, then click Network File Storage.

On the Create a Network File Storage Share page select your options for the new share:

• Choose a datacenter region: Select the region to create the share in.
• VPC network: Select the VPC network to attach the share to. You can attach the share to additional VPC networks after you create it. All Droplet and DOKS resources must be in one of the share’s VPC networks to access it.
• Choose a storage tier: Select the storage tier for the share. Standard provides up to 1 Gbps throughput for general-purpose workloads. High Performance provides higher throughput that scales with share size. See NFS features for a full comparison.
• Choose a storage size: Enter the share size in GiB. Standard Tier shares must be at least 50 GiB. High Performance Tier shares must be at least 500 GiB.
• Finalize: Enter a name for your share. Names must be lowercase letters and can contain dashes. Names must be unique within your team account.

In the Summary section, review the selected configuration, then click Create Network File Storage to create your share.

The Network File Share overview page loads, where all of your NFS shares are listed in a table with the following details:

• Name: The unique name you gave your share.
• Status: Whether the share is New, Active, or Detached.
• VPC Network: The VPC network the share is attached to.
• Mount Source: The IP address and path of the share. Use this to mount the share on a Droplet.
• Created: The timestamp of when the share was created.
• …: The “more” menu provides Mounting Instructions and actions to Resize, Create Access Point, Attach another VPC or Detach from VPC, and Delete.

To use the share, you need to mount it on a Droplet or Kubernetes cluster. You can view mounting instructions from the … menu next to the share. Click the … menu, then click Mounting Instructions to open a window with a mounting guide that has step-by-step instructions, preconfigured with the share’s address, for connecting your share to a Droplet or Kubernetes cluster.

For further information read How to Mount a Network File Storage Share.