The Volumes page provides comprehensive tools for managing your storage, including attaching, detaching, and deleting volumes.

Attaching Volumes

To attach a volume to a VM:

1

Select Volume

Click Attach on an available volume card

2

Review Volume Details

The Volume Attach Modal opens showing:

  • Volume details (name, size, region, type)
  • List of VMs in the same region with ACTIVE status
  • VM information (name, status, region) in a table format
3

Select Target VM

Select a VM using the radio button selection

4

Confirm Attachment

Click “Attach Volume” to confirm

Volume Attach Modal Features

Smart VM Filtering

Intelligent VM Selection

  • Only shows VMs in the same region as the volume
  • Filters by ACTIVE status for compatibility
  • Displays VM information clearly
  • Prevents incompatible attachments

Status Validation

Comprehensive Validation

  • Only ACTIVE VMs can be selected for attachment
  • Visual status indicators with color coding (green for ACTIVE)
  • Helpful messages explaining why non-ACTIVE VMs cannot be selected
  • Auto-selection of the first ACTIVE VM if available

Attachment Requirements

Prerequisites for Volume Attachment:

  • VM must be in ACTIVE state for volume operations
  • Volume and VM must be in the same region
  • Bootable volumes that are already in use cannot be attached to another VM
  • VM must not be undergoing another operation

The system includes loading states that show progress during attachment operations, ensuring you have real-time feedback on the process.

Detaching Volumes

To detach a volume from a VM:

1

Initiate Detachment

Click Detach on an attached volume

2

Review Warning

A confirmation modal appears with volume details and warnings

3

Acknowledge Impact

Review the warning about potential application disruption

4

Confirm Detachment

Click “Detach” to confirm the operation

Smart Detachment System

The platform includes an intelligent detachment system:

  • VM Identification: System automatically finds the VM to detach from
  • Multi-source VM ID: Uses instance_id, attached volume mapping, or region-based VM search
  • Relationship Mapping: Tracks volume-VM relationships automatically

Detachment Requirements

VM Status

Active VM Required

  • VM must be in ACTIVE state for volume detachment
  • Cannot detach during VM state transitions
  • System validates VM availability before proceeding

System Volumes

Boot Volume Protection

  • Cannot detach the system/boot volume of a running VM
  • System identifies and protects critical volumes
  • Prevents accidental system disruption

Deleting Volumes

To delete a volume:

1

Ensure Detachment

Volume must be detached from all VMs first

2

Initiate Deletion

Click Delete on an unattached volume

3

Review Confirmation

A delete confirmation modal appears showing:

  • Volume name to be deleted
  • Warning that action cannot be undone
  • Permanent data loss warning
4

Confirm Deletion

Click “Delete” to confirm the permanent deletion

Delete Confirmation Modal

The deletion process includes comprehensive safeguards:

Deletion Requirements

Volume Deletion Prerequisites:

  • Volumes must be detached before deletion
  • Deletion is permanent and cannot be undone
  • All data on the volume will be permanently lost
  • Any snapshots of the volume will remain available

Volume Status Indicators

Volumes display status indicators to show their current state:

The volume is ready to be attached to a VM

Volume Information Display

Each volume card displays comprehensive information:

Header Information

  • Volume Name: User-defined identifier with database icon
  • Status Badge: Current operational state with color coding
  • Attachment Info: Shows which VM the volume is attached to (if any)
  • VM Status: Displays the status of the attached VM for operational context

Specifications Grid

  • Size: Storage capacity in GB
  • Region: Geographic location (NORWAY-1, CANADA-1, US-1)
  • Type: Storage type (Cloud-SSD)
  • Bootable Status: Whether the volume can be used to boot VMs

Action Buttons

Dynamic buttons based on volume state:

  • Attach/Detach: Available based on current attachment status
  • Delete: Only available for unattached volumes

Storage Best Practices

Volume Management Tips

Refresh and Data Management

Keep your volume data current:

  • Automatic Refresh: The page automatically refreshes after volume operations to show updated status
  • Loading States: Visual progress indicators show progress for create, attach, detach, and delete operations
  • Pagination Management: Pagination automatically adjusts when volumes are added or removed
  • Regional Filtering: Region filtering allows you to manage volumes across different geographic locations
  • Real-time Updates: Volume statistics update in real-time as you perform operations

Error Handling and Recovery

Common Issues and Solutions:

  • VM Not Active: Wait for VM to reach ACTIVE state before attaching
  • Region Mismatch: Ensure volume and VM are in the same region
  • Volume In Use: Check if volume is already attached to another VM
  • Insufficient Permissions: Verify account permissions and status

Integration with VM Workflow

Seamless Operations

Volume management integrates seamlessly with your VM workflow:

  • Live Management: Attach and detach volumes without VM downtime (for data volumes)
  • Performance Monitoring: Real-time status updates and performance metrics
  • Automated Detection: System automatically detects volume-VM relationships
  • Consistency Checks: Validates operations to prevent configuration conflicts

Workflow Examples

1

Development Environment

  • Create volumes for project data and dependencies
  • Attach volumes to development VMs as needed
  • Detach and reattach volumes to different VMs for testing
  • Delete temporary volumes when projects are complete
2

Production Deployment

  • Create bootable volumes with production configurations
  • Attach data volumes to production VMs for persistence
  • Implement backup strategies with regular snapshots
  • Manage volume lifecycle based on business requirements
3

Disaster Recovery

  • Create cross-region volume backups using snapshots
  • Test volume restoration procedures regularly
  • Document volume dependencies and relationships
  • Implement automated recovery workflows

Regular monitoring of volume status and proactive management helps prevent issues and optimizes performance across your entire infrastructure.