Skip to main content
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:
  • Automatic Detection
  • Status Validation
  • Error Handling
  • 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:
  • Volume Identification: Shows exact volume name being deleted
  • Irreversible Action: Warning triangle icon with danger messaging
  • Data Loss Notice: Clear statement that action cannot be undone
  • Final Confirmation: Separate confirmation required to proceed
  • Disable During Process: Delete button becomes disabled during processing
  • Loading State: Shows spinner animation during deletion
  • Error Handling: Clear error messages if deletion fails
  • Status Updates: Real-time feedback on deletion progress

​
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:
  • Operational States
  • Transitional States
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

Optimize Performance and Compliance
  • Create volumes in the same region as your VMs to avoid compatibility issues
  • Consider data residency requirements for compliance
  • Plan for disaster recovery across multiple regions
  • Monitor regional availability and pricing differences
Right-size Your Storage
  • Size volumes appropriately for your workload to optimize cost
  • Plan for growth but avoid over-provisioning
  • Monitor usage patterns and adjust capacity as needed
  • Use bootable volumes for persistent OS configurations that you want to reuse
Safeguard Your Information
  • Detach volumes before deleting VMs if you want to preserve the data
  • Consider creating snapshots before major changes to ensure data recovery options
  • Monitor your volume usage to avoid unnecessary storage costs
  • Complete your profile and maintain sufficient credits before creating volumes
Streamline Your Workflow
  • Use descriptive naming conventions for easy identification
  • Regular cleanup of unused volumes to manage costs
  • Implement consistent attachment/detachment procedures
  • Monitor volume performance and optimize as needed

​
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

  • Attachment Failures
  • Detachment Issues
  • Deletion Problems
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.
⌘I