Mounting Shared Storage

Mount persistent storage volumes to your GPU instances across different providers.

Overview

Persistent storage volumes provide shared, network-attached storage that can be attached to your GPU instances. These volumes persist independently of your instances, allowing you to preserve data across deployments.

Key Features:

✅ Persistent storage that survives instance termination
✅ Can be attached to multiple instances simultaneously
✅ Provider-specific mounting protocols optimized for performance
✅ Dynamically attach and detach from running instances
✅ Pay only for storage capacity used

Prerequisites

Before mounting a volume, ensure you have:

✓ Created a persistent storage volume via the Volumes API
✓ Attached the volume to your GPU instance
✓ Retrieved the volume's connection details (virtual IP, mount path, protocol)
✓ SSH access to your instance

Provider-Specific Mounting Guides

Select your provider below for detailed mounting instructions:

Voltage Park

Protocol: Network File System (NFS) v3 Status: ✅ Available

Mount high-performance NFS volumes on Voltage Park instances with parallel connection support.

View Voltage Park Mounting Guide →

Key Features:

NFS v3 protocol with high-performance nconnect option
Virtual IP-based network mounting
Supports concurrent multi-instance access
Automatic fstab configuration for boot persistence

Other Providers

Status: 🚧 Coming Soon

Support for additional providers is in development. Each provider may use different protocols and mounting procedures optimized for their infrastructure.

Planned Providers:

TensorDock - Coming Soon
DataCrunch - Coming Soon
Sesterce - Coming Soon

Check back for updates or contact support if you need volume mounting support for a specific provider.

General Concepts

Volume Lifecycle

Create Volume → Attach to Instance → Mount → Use → Unmount → Detach → Delete
     ↓              ↓                  ↓       ↓         ↓         ↓        ↓
  Available     Available          Attached  Attached  Attached  Available Deleted

Common Operations

Creating Volumes: Use the Volumes API to create persistent storage volumes:

curl -X POST "https://app.spheron.ai/api/volumes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-data-volume",
    "sizeInGb": 100,
    "provider": "voltage-park"
  }'

Attaching Volumes: Attach volumes to running instances:

curl -X POST "https://app.spheron.ai/api/volumes/{volumeId}/attach" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deploymentId": "your_deployment_id"}'

Mounting: Follow provider-specific mounting instructions (see links above).

Detaching Volumes: Unmount first, then detach via API:

curl -X POST "https://app.spheron.ai/api/volumes/{volumeId}/detach" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deploymentId": "your_deployment_id"}'

Additional Resources

Volume API Reference - Create and manage volumes programmatically
External Storage Access - Configure local NVMe drives on Voltage Park
SSH Connection Setup - Secure instance access
Security Best Practices - Secure your storage and data
Getting Started - Complete deployment guide

Need Help?

Documentation: Browse our guides
Community: Join our Discord
Support: Contact us for enterprise volume mounting assistance

Select your provider above to view detailed mounting instructions.