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

A Network File Storage (NFS) share connects to one or more VPC networks in the same region. You can attach a share to up to 10 VPC networks at once, which lets Droplets and DOKS clusters in different VPC networks mount the same share. Each attached VPC network receives its own mount IP address, and the share stores a single copy of your data that all attached networks reach over separate network paths.

To move a share from one VPC network to another, detach it from the current network and attach it to the new one.

Attach and Detach VPC Networks Using Automation

To attach a share to a VPC network using the API, set the action type to attach and provide the share’s region and the vpc_id of the network to attach:

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
    -d '{ "type": "attach", "region": "atl1", "params": {"vpc_id": "<your_vpc_id>"}}' \
    "https://api.digitalocean.com/v2/nfs/<your_share_id>/actions"

Replace <your_vpc_id> with the ID of the VPC network to attach and <your_share_id> with the ID of your share.

To detach a share from a VPC network, set the action type to detach and provide the same region and vpc_id attributes.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"type": "resize", "params": {"size_gib": 1024}, "region": "atl1"}' \
  "https://api.digitalocean.com/v2/nfs/${nfs_id}/actions"

Attach a VPC Network Using the Control Panel

To attach a share to an additional VPC network from the control panel, click Network File Storage in the main menu.

On the Network File Storage page, find the share in the list, then click its … menu, then click Attach another VPC.

In the Attach this share to another VPC window, select the VPC network you want to attach the share to, then click Attach to VPC. The VPC network must be in the same region as the share.

Reload the Network File Storage page to see the new mount source for the attached network. Use this mount IP address to mount the share from Droplets and DOKS clusters in that VPC network.

Detach a VPC Network Using the Control Panel

To detach a share from a VPC network, click the share’s … menu, then click Detach from VPC.

In the confirmation window, enter the name of the share, then click Detach. Detaching a share from a VPC network immediately stops clients in that network from reaching the share through its mount IP address. Data on the share is not affected.

Move a Share Between VPC Networks

To move a share from one VPC network to another in the same region, detach it from the current network and then attach it to the new one using the steps above.