Vultr DocsLatest Content

How to Add an Export for an Existing Vultr Storage Gateway

Updated on 05 June, 2025

Vultr Storage Gateway (an NFS Gateway for Vultr File System) enables scalable NFS-based access to VFS volumes from Vultr Bare Metal and Cloud Compute instances. Adding an export to an existing gateway lets you

  • Share a single VFS volume across multiple Bare Metal instances.
  • Attach multiple VFS volumes to a single instance.
  • Manage shared storage more efficiently across your infrastructure.

Follow this guide to create an export for an existing Vultr Storage Gateway using the Vultr API.

  1. Send a GET request to the List Storage Gateways endpoint to retrieve the available Vultr Storage Gateways.

    console 
    $ curl "https://api.vultr.com/v2/storage-gateways" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

  2. Send a GET request to the List VFS endpoint to retrieve available Vultr File System volumes.

    console 
    $ curl "https://api.vultr.com/v2/vfs" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

  3. Send a POST request to the Add Storage Gateway Export endpoint to add a new export for an existing Storage Gateway.

    console 
    $ curl "https://api.vultr.com/v2/storage-gateways/<storage-gateway-id>/exports" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    --data '{
        "label": "<my-export-label>",
        "pseudo_root_path": "<export-path>",
        "vfs_uuid": "<vfs-volume-id>",
        "allowed_ips": [
            "<bare-metal-ip>/32"
        ]
    }'

  4. Send a GET request to the Storage Gateway endpoint using the Storage Gateway ID to verify that the export was created.

    console 
    $ curl "https://api.vultr.com/v2/storage-gateways/<storage-gateway-id>" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"