1. Volumes
Barrack API Documentation
  • Platform Documentation
    • Getting Started
    • Authentication & Access
    • Account Management
    • API Keys
    • GPU Models
    • Regions
    • Instance
      • OS Images
      • Bootsource Management
      • Deploy Instance
      • Instance Management
      • Hibernation
      • View Instances
    • Billing
      • Credit Depletion & Resource Protection
    • SSH Keys
      • Add SSH Keys
      • Manage SSH Keys
      • Connecting to Your VM via SSH
    • Volumes
      • Overview
      • Create Volume
      • List and View Volumes
      • Attach Volumes
      • Detach Volumes
      • Clone Volumes
      • Resize Volume
      • Delete Volume
    • Advanced Configurations
      • Network And Security
      • Cloudinit Script
      • Startup Script
    • Firewall
      • Manage Firewall
      • Rules and Attachment
    • Snapshot
      • Overview
      • Manage Snapshots
      • Restore Snapshots
    • Custom Images
      • Overview
      • Create and Manage Images
  • Balance
    • Get credit balance
      GET
  • Deploy Instance
    • Create a new instance
      POST
  • Pricing
    • Get pricing information
      GET
    • Get pricing information
      POST
  • Instances
    • List instances
    • Delete instance
    • Hibernate instance
    • Reboot instance
    • Restore hibernated instance
    • Start instance
    • Stop instance
    • Toggle public IP for instance
    • Get instance details
    • Get firewalls attached to instance
    • Add instance security rule
    • Remove instance security rule
    • Get instance billing
    • List Instance eligible for snapshot creation
  • SSH Keys
    • List SSH keys
    • Create SSH key
    • Get SSH key
    • Delete SSH key
  • Volumes
    • Attach volumes to instance
    • Detach volumes from instance
    • List volumes
    • Create volume
    • Get volume details
    • Delete volume
    • Clone volume
    • Resize volume
    • Get volume billing
    • List available volume types
  • Scripts
    • List all startup scripts
    • Create a startup script
    • Get startup script details
    • Update a startup script
    • Delete a startup script
    • Delete multiple startup scripts
  • Snapshots
    • Create snapshot
    • List snapshots
    • Get snapshot details
    • Delete snapshot
    • Restore snapshot
    • Get snapshot billing
  • Images
    • List custom images
    • Get image details
    • Delete custom image
    • List OS images
    • Create image from snapshot
    • Get snapshot-image relationship
    • Get snapshot-image relationship list
  • Firewalls
    • List firewalls
    • Get firewall details
    • Attach firewall to instances
    • Delete firewall
    • Remove firewall rule
    • Add firewall rule
    • Create firewall
    • List instances available for firewall attachment
    • Get supported protocols
  • GPU Stocks
    • Get GPU stock availability
  • GPU Specs
    • Get GPU specifications
  • Regions
    • List available regions
  • Schemas
    • AddFirewallRuleRequest
    • APIKeyResponse
    • AddFirewallRuleResponse
    • AddVMSecurityRuleResponse
    • AttachFirewallRequest
    • AggregatedBillingResponse
    • AttachFirewallResponse
    • AttachVolumesRequest
    • AttachVolumesResponse
    • AttachedFirewall
    • BatchSnapshotImageRelationshipResponse
    • Balance
    • Billing
    • ChatCompletionsRequest
    • ChatCompletionsResponse
    • CloneVolumeRequest
    • BillingRecord
    • BillingBreakdown
    • CloneVolumeResponse
    • BillingSummary
    • CreateFirewallRequest
    • CreateFirewallResponse
    • BootSourceEnum
    • CreateImageFromSnapshotRequest
    • BulkDeleteResponse
    • CreateSSHKeyRequest
    • CreateScriptRequest
    • CreateSnapshotRequest
    • CreateSnapshotResponse
    • CreateSSHKeyResponse
    • ComputeBilling
    • CurrencyEnum
    • Data
    • CreditBalanceResponse
    • CreateAPIKeyRequest
    • DeleteFirewallResponse
    • CreateVolumeRequest
    • CreateAPIKeyRequestTierEnum
    • DeleteSnapshotResponse
    • CreateVolumeResponse
    • CreateAPIKeyResponse
    • DeleteVMResponse
    • DetachVolumesRequest
    • DetachVolumesResponse
    • DeploymentRequest
    • DirectionEnum
    • DeploymentResponse
    • CreateSnapshotData
    • EthertypeEnum
    • ErrorResponse
    • FirewallAttachment
    • DeleteVolumeResponse
    • DeleteSSHKeyResponse
    • FirewallEnvironment
    • FirewallResponse
    • FirewallRule
    • FirewallVM
    • DataVolumeBilling
    • GetBatchSnapshotImageRelationshipsRequest
    • GetFirewallDetailsResponse
    • GPUStockConfiguration
    • GPUSpec
    • GetHibernatedVMsResponse
    • GPUStockItem
    • GPUSpecsResponse
    • GetSupportedProtocolsResponse
    • GPUStocksResponse
    • GetVMAttachedFirewallsResponse
    • DeploymentData
    • DeleteAPIKeyResponse
    • GetVolumeTypesResponse
    • HibernateVMResponse
    • HibernationBillingMetrics
    • ListFirewallsResponse
    • ListUserVMsResponse
    • ListVMsResponse
    • DeploymentDataStatusEnum
    • ModelsResponse
    • GetSSHKeysResponse
    • Pagination
    • PricingRequest
    • OSImage
    • Deposit
    • PricingResponse
    • OSImagesResponse
    • DepositStatusEnum
    • Protocol
    • GpuCountEnum
    • FirewallInstance
    • ProtocolEnum
    • Image
    • GpuModelEnum
    • GetVolumeDetailsResponse
    • RebootVMResponse
    • ImageCreateResponse
    • RecentHibernation
    • ImageDeleteResponse
    • GetVolumesWithNextNameResponse
    • RemoveFirewallRuleResponse
    • ImageDetailResponse
    • RemoveVMSecurityRuleResponse
    • Region
    • ImageListResponse
    • ResizeVolumeRequest
    • RegionsResponse
    • Price
    • ResizeVolumeResponse
    • ResourceTypeEnum
    • RestoreSnapshotRequest
    • RestoreSnapshotResponse
    • GetSSHKeyDetailResponse
    • RestoreVMResponse
    • Snapshot
    • SnapshotImageRelationshipResponse
    • GetSnapshotDetailsResponse
    • Specs
    • StartVMResponse
    • GpuBilling
    • StopVMResponse
    • TierEnum
    • UpdateScriptRequest
    • UsageHistoryResponse
    • UsageSummaryResponse
    • RegionEnum
    • UserVM
    • VMDetailsResponse
    • VMFlavor
    • InstanceFeatures
    • VMImage
    • InstanceSpecs
    • VMInstance
    • IpStatusEnum
    • VMResponse
    • SpecsMetadata
    • VMSecurityRule
    • VMSecurityRuleRequest
    • VMStatus
    • VMVolumeAttachment
    • Script
    • ListFirewallInstancesResponse
    • VolumeTypeEnum
    • SSHKeyResponse
    • ScriptListResponse
    • OsVolume
    • ListSnapshotsResponse
    • ListVMsForSnapshotResponse
    • ListAPIKeysResponse
    • PricingRequestVolumeTypeEnum
    • ToggleVMPublicIPResponse
    • PatchedDeposit
    • PatchedTransaction
    • PaymentMethodEnum
    • VolumeBillingRecord
    • VolumeBillingSummary
    • VolumeHourlyBillingResponse
    • SecurityRule
    • ScriptCreateResponse
    • RestoreSnapshotData
    • ScriptDeleteResponse
    • ScriptDetailResponse
    • VolumeResponse
    • ScriptUpdateResponse
    • StatusEnum
    • StorageBilling
    • SnapshotBillingRecord
    • SnapshotBillingResponse
    • SnapshotBillingSummary
    • SnapshotDetail
    • SnapshotListItem
    • SnapshotVMResponse
    • Tier528Enum
    • TokenObtainPair
    • TokenRefresh
    • Transaction
    • VolumeCreate
    • TransactionTypeEnum
    • VolumeCreateVolumeTypeEnum
    • VolumeRate
    • UserProfile
    • VMDetailVolumeAttachment
    • VMOperations
    • VMSpecs
    • VolumeTypeItem
    • VolumeTypesByTier
  1. Volumes

Clone Volumes

This guide covers cloning storage volumes to create exact copies with all data preserved. Cloning creates a new volume with identical data from the source volume.
Coming March 2026: Clone operations will be available in Advanced Tier regions (FINLAND-1/2/3) when they launch. Legacy Tier (CANADA-1) does not support cloning.

Prerequisites#

Before cloning, ensure you meet the general volume prerequisites.
Clone-Specific Requirements:
Source volume in advanced tier region (FINLAND-1/2/3)
Volume status: Available OR Attached to SHUTOFF instance
Clone destination: Same region as source (cross-region not supported)
Unique name for clone within target region
Important: Cloning is only available in advanced tier regions. Legacy regions (CANADA-1) do not support cloning.

Clone Configuration#

PropertyBehaviorOptions
NameRequired unique nameDefault: {source}-clone. Rules: 3-30 chars, alphanumeric + _-
SizeInherited from sourceCannot change during clone. Use resize after.
Volume TypeSelectableKeep source type OR switch between NVMe/HDD
RegionSame as sourceCross-region not supported
BootableInherited from sourceMatches source volume bootable status

Volume Type Options#

NVMe — High-performance NVMe storage ($219.00/TB/month USD)
Low latency, high IOPS
Best for databases and I/O intensive workloads
HDD — Cost-effective magnetic storage ($58.40/TB/month USD)
Higher latency, lower cost
Best for backups, archives, and sequential workloads
Choose based on your performance vs. cost requirements.

Cloning a Volume#

Step 1: Select Source Volume#

1.
Go to barrack.ai/volumes
2.
Use region dropdown to filter volumes. Source volume must be in an advanced tier region.
3.
Find the volume you want to clone. Click the info icon (ℹ️) on the volume card to view details.

Step 2: Verify Clone Eligibility#

Check source volume status and instance state.
Eligible Volumes:
Status: "Available" (not attached to any instance)
Status: "Attached" with instance status: "SHUTOFF"
Ineligible Volumes:
Attached to any instance that is not in SHUTOFF status (shut down instance first)
In "Creating" state (wait for completion)
Located in legacy region CANADA-1 (not supported)

Step 3: Initiate Clone Operation#

In the volume details modal:
1.
Click "Clone" button in the Advanced Operations section
2.
Clone modal opens with pre-filled information
Pre-filled Data:
Clone name: {source-volume-name}-clone
Size: Inherited from source (read-only)
Region: Source volume region (read-only)
Volume type: Source volume type (modifiable)

Step 4: Configure Clone Settings#

Clone Name:
Edit the suggested name if desired. Name must be:
Unique in target region
3-30 characters
Letters, numbers, hyphens, underscores only
Cannot start/end with hyphen or underscore
Volume Type:
Select volume type for clone:
Keep source type OR
Change to different type (NVMe/HDD)
Pricing Information:
The modal displays:
Per TB monthly rate for selected type
Total monthly cost based on volume size
Currency (USD/EUR/INR based on account)

Step 5: Confirm Clone#

Review configuration and click "Clone Volume" button.
Clone Process:
1.
System validates source volume status
2.
System checks instance state (if attached)
3.
System verifies sufficient credits
4.
System validates region restrictions
5.
System checks name uniqueness
6.
Barrack creates volume clone
7.
New volume appears in volumes list
8.
Billing starts for cloned volume
Clone operation is initiated immediately. Completion time depends on volume size. The cloned volume will appear in your volume list once the operation completes.

Step 6: Verify Clone#

After clone completes:
Volume List Updates:
New volume appears with clone name
Status shows "Available"
Size matches source volume
Selected volume type displayed
Same region as source
Clone Data:
All data from source volume preserved
Filesystem intact
Files accessible immediately after attachment

Validation#

The system validates before proceeding:
Volume Checks:
Exists and belongs to your account
Status is Available or Attached to SHUTOFF instance
Located in advanced tier region (not CANADA-1)
Size within supported limits
Instance Validation (if attached):
Instance status must be SHUTOFF
Any other instance status will be rejected
Name & Region:
Clone name is unique in target region
Target region matches source region
Follows naming rules (3-30 chars, alphanumeric + _-)
Account Status:
Sufficient credits for cloned volume billing
Profile complete with minimum balance

Post-Clone Status#

Cloned Volume#

Status:
Initially "Creating" during clone process
Changes to "Available" when ready
Ready for attachment to any instance
Properties:
Same size as source volume
Selected volume type (NVMe or HDD)
Bootable status inherited from source volume
Same region as source
Data:
Complete copy of source volume data
All files and filesystem preserved
No data loss or corruption
Independent from source volume

Source Volume#

Source volume status unchanged
Data remains intact
Still available for use
Can be cloned again if needed

Billing Impact#

Cloned Volume Billing:
Billing starts immediately after creation
Hourly rate based on size and type
Independent billing from source volume
Same rates as creating new volume
Source Volume Billing:
Continues unchanged
No impact from clone operation

Pricing#

Cloned volumes use the same pricing as new volumes.
Advanced Tier (NVMe):
CurrencyRate
USD$219.00/TB/month
EUR€255.50/TB/month
INR₹21,900/TB/month
Advanced Tier (HDD):
CurrencyRate
USD$58.40/TB/month
EUR€73.00/TB/month
INR₹5,840/TB/month
Billing: Starts immediately after clone creation. Charged hourly based on size and type. Independent billing from source volume.
Examples:
Clone 500GB NVMe volume: (500 ÷ 1024) × 219.00= 106.93/month
Clone 2TB HDD volume: (2048 ÷ 1024) × 58.40= 116.80/month

Troubleshooting#

Volume can only be cloned when available or attached to shut off instance#

Cause: Source volume attached to an instance that is not in SHUTOFF status.
Fix:
1.
Navigate to instances page
2.
Shut down the attached instance
3.
Wait for SHUTOFF status
4.
Retry clone
Verify: Instance shows "SHUTOFF" before cloning.

Cross-region cloning not supported#

Cause: Attempting to clone to a different region.
Fix: Clone must be in the same region as source. This is a platform restriction for data consistency and performance.
Options:
Clone in source region, then manually transfer data
Create new volume in target region and copy data
Cross-region cloning may be added in future updates.

Cloning only supported for advanced tier regions#

Cause: Source volume in CANADA-1 (legacy region).
Fix: Cloning is only available in FINLAND-1, FINLAND-2, and FINLAND-3.
Options:
Use advanced tier volumes for cloning
Create new volume and manually copy data
Consider migrating to advanced tier regions

Clone Button Disabled#

Common Causes:
Volume attached to an instance that is not SHUTOFF → Shut down instance first
Volume in "Creating" state → Wait for provisioning to complete
Volume in CANADA-1 region → Cloning not supported
Hover over the disabled button to see the specific reason in the tooltip. Address the issue before retrying.

Best Practices#

Before Cloning:
Verify source data is current and backed up
Ensure sufficient credits for new volume billing
Choose volume type (NVMe vs HDD) based on performance needs
Plan unique naming convention for clones
Shut down attached instance if required
During Clone:
Don't modify source volume during clone process
Don't delete source volume during clone process
Wait for completion before attaching
Monitor account credits for new volume charges
After Clone:
Verify clone status shows "Available"
Test data accessibility after attachment
Verify all files present and accessible (ls -lah)
Check filesystem integrity (df -h)
Update documentation with clone details
Consider deleting source if no longer needed

Next Steps#

1.
Verify Clone — Check volume appears in volumes list with "Available" status and correct size/type.
2.
Attach to Instance — Navigate to cloned volume, click "Attach", select target instance (SHUTOFF), and confirm. See Attach Volumes for detailed instructions.
3.
Mount in OS — Start instance, SSH in, identify device (lsblk), and mount volume (mount /dev/vdb /mnt/data). See Attach Volumes - Instance Configuration for OS-level mounting.
4.
Verify Data — Check all files present, verify filesystem integrity, and test file access.
5.
Update Applications — Update application configurations to use new volume if replacing original.

Support#

For clone assistance, contact [email protected]. Include: source volume ID/name, clone name attempted, error messages received, request ID (if applicable), and region.
Related: Resize Volumes — Increase cloned volume size after creation. Requirements: volume status Available or Attached, new size larger than current, advanced tier region only.
Previous
Detach Volumes
Next
Resize Volume
Built with