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

Create Volume

Navigate to barrack.ai/volumes and click Create Volume to open the volume creation modal. If the button is disabled, hover over it to see the specific requirement (incomplete profile or insufficient balance).

Requirements#

Profile Complete: Complete your profile at barrack.ai/account with billing information (name, address, postal code, country).
Minimum Balance: Account balance must meet minimum:
USD: $1.00
EUR: €1.00
INR: ₹100.00

Region Capabilities#

Legacy Tier (CANADA-1)#

Volume Type: SSD only
Size Range: 100 GB – 102,400 GB
Bootable Volumes: Supported (Ubuntu)
Clone/Resize: Not available
Pricing: $73.00/TB/month

Advanced Tier (Nordic) — Coming March 2026#

Regions: FINLAND-1, FINLAND-2, FINLAND-3
Volume Types: NVMe or HDD
Size Range: NVMe (100–10,000 GB), HDD (100–16,000 GB)
Bootable Volumes: Not supported
Clone/Resize: Available
Pricing: NVMe 219.00/TB/month,HDD58.40/TB/month
Note: Advanced Tier regions (FINLAND-1/2/3) are launching in March 2026. Volume creation in these regions will be available after launch. Legacy Tier (CANADA-1) is available now.
Important: Volumes cannot be moved between regions after creation. Region selection is permanent.

Creating a Volume#

Step 1: Select Region#

Choose your deployment region from the dropdown:
CANADA-1 — Legacy Tier (bootable volumes, SSD)
FINLAND-1/2/3 — Advanced Tier (clone/resize, NVMe/HDD) — Coming March 2026

Step 2: Enter Volume Name#

Requirements:
Length: 3–30 characters
Allowed: Letters, numbers, hyphens (-), underscores (_)
Cannot start or end with hyphen/underscore
Must be unique within selected region
Examples:
Valid: data-volume-1, backup_storage, prod_db_vol
Invalid: vo (too short), -data (starts with hyphen), my volume (contains space)

Step 3: Select Volume Type & Size#

Legacy Tier (CANADA-1)#

Volume Type: SSD (automatically selected)
Size Range: 100 GB – 102,400 GB
Pricing:
$73.00/TB/month (USD)
€73.00/TB/month (EUR)
₹7,300/TB/month (INR)

Advanced Tier (Nordic) — Coming March 2026#

NVMe — High-performance storage
Size: 100 GB – 10,000 GB
$219.00/TB/month (USD) | €255.50/TB/month (EUR) | ₹21,900/TB/month (INR)
HDD — Cost-effective storage
Size: 100 GB – 16,000 GB
$58.40/TB/month (USD) | €73.00/TB/month (EUR) | ₹5,840/TB/month (INR)
Size Input:
Enter numeric value (GB suffix is automatic)
Use up/down arrows or keyboard ↑/↓ to adjust by 100 GB
Real-time pricing updates as you adjust size

Step 4: Configure Bootable Volume (CANADA-1 Only)#

Note: This option is only available for CANADA-1 region. It is hidden for advanced tier regions.
To create a bootable volume:
1.
Enable "Make Bootable" toggle
2.
Select Ubuntu image from dropdown
3.
Image selection is required when bootable is enabled
Bootable Volume Restrictions (CANADA-1 only):
Cannot be detached once attached to an instance
Attachment is permanent for instance lifetime
Cannot be converted to non-bootable after creation
Non-Bootable Volumes:
Can be attached and detached freely (when instance is SHUTOFF)
Available in all regions
No OS image required

Step 5: Create Volume#

Click Create to submit. Volume creation typically completes within 30 seconds.
After Creation:
Volume appears in volumes list with "Available" status
Billing begins immediately (hourly rate based on size)
Volume is ready for attachment to instances

Troubleshooting#

Profile incomplete error#

Error: "Please complete your profile before creating volumes"
Resolution:
1.
Navigate to barrack.ai/account
2.
Complete all required fields (name, address, postal code, country)
3.
Save and return to volume creation

Insufficient credits error#

Error: "Insufficient credits to create volume"
Resolution:
1.
Check your current balance
2.
Add credits to meet minimum requirement ($1 USD / €1 EUR / ₹100 INR)
3.
Retry volume creation

Duplicate name error#

Error: "A volume with this name already exists"
Resolution:
1.
Choose a different volume name
2.
Names must be unique within each region
3.
Same name can exist in different regions

Invalid volume size error#

Error: "Volume size must be at least 100 GB" or "Size cannot exceed [max] GB"
Resolution:
1.
Ensure size is at least 100 GB
2.
Check maximum for volume type: SSD (102,400 GB), NVMe (10,000 GB), HDD (16,000 GB)
3.
Adjust to valid range

Invalid volume type error#

Error: "Invalid volume type for the selected region"
Resolution:
1.
CANADA-1 supports SSD only
2.
Nordic regions support NVMe or HDD only
3.
Select appropriate type for your region

Bootable volumes not supported error#

Error: "Bootable volumes from OS images are not supported in this region"
Resolution:
1.
Bootable volumes are only available in CANADA-1
2.
Disable bootable option for advanced tier regions
3.
Or switch to CANADA-1 for bootable volumes

OS image required error#

Error: "An OS image is required for bootable volumes"
Resolution:
1.
Select an OS image from dropdown when bootable is enabled
2.
Wait for images to load if spinner is shown
3.
If images fail to load, toggle bootable off and on again

Support#

Email Support: [email protected] — Include volume name, region, and error messages.
Next: Attach Volume — Connect your volume to an instance. Requirements: Volume Available, Instance SHUTOFF.
Previous
Overview
Next
List and View Volumes
Built with