Vultr DocsLatest Content


How to Add an Export for an Existing Vultr Storage Gateway

Updated on 11 September, 2025

Learn how to add an export to an existing Vultr Storage Gateway to share data with clients


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}"