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.

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.