1. Instance
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
      GET
    • Delete instance
      DELETE
    • Hibernate instance
      POST
    • Reboot instance
      POST
    • Restore hibernated instance
      POST
    • Start instance
      POST
    • Stop instance
      POST
    • Toggle public IP for instance
      POST
    • Get instance details
      GET
    • Get firewalls attached to instance
      GET
    • Add instance security rule
      POST
    • Remove instance security rule
      DELETE
    • Get instance billing
      GET
    • List Instance eligible for snapshot creation
      GET
  • 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. Instance

Deploy Instance

Deploy GPU-accelerated instances with custom hardware configurations and storage options.

Prerequisites#

Complete these requirements before deploying:
1
Account Authentication
Log in to your account. Unauthenticated users cannot deploy instances.
2
Complete Profile
Ensure your account profile contains:
Full name
Billing address (address line 1)
Postal code
Country
Navigate to Account Settings to complete missing information.
3
Verify Balance
Confirm sufficient account balance for hourly deployment costs. Deployments require minimum one hour of prepaid balance.

Deployment Configuration#

1. GPU Configuration#

Configure GPU model and quantity for your instance. View complete GPU specifications and selection guide.
Available GPU Models:
GPU ModelTierStatus
H100-PCIe-NVLink-80GBLegacyAvailable Now
H100-PCIe-80GBLegacyAvailable Now
A100-PCIe-80GBLegacyAvailable Now
L40LegacyAvailable Now
RTX-A6000LegacyAvailable Now
B300-262GBAdvancedComing Soon
B200-180GBAdvancedComing Soon
H200-141GBAdvancedComing Soon
H100-SXM5-80GBAdvancedComing Soon
All GPU models support quantities: 1, 2, 4, or 8.

2. Region Selection#

Select the deployment region for your instance. Available regions are determined by your GPU selection.
Available Regions:
RegionTierStatus
CANADA-1LegacyAvailable Now
FINLAND-1AdvancedComing Soon
FINLAND-2AdvancedComing Soon
FINLAND-3AdvancedComing Soon

3. Boot Source#

Select how your instance will start. Complete boot source configuration guide.
Boot Source Options:
OS Images: Deploy from platform-provided operating system images
Existing Volume: Boot from an existing bootable volume
Custom Images: Deploy from user-uploaded custom images (authenticated users only)
Configuration requirements vary by boot source type and region.

4. SSH Key Configuration#

Configure SSH access to your instance. Create new SSH keys or import existing keys if you haven't already.
SSH key requirements vary by deployment type and region:
Deployment TypeLegacy RegionAdvanced Region (Coming Soon)
OS Image deploymentRequiredRequired
Volume bootRequiredNot allowed (uses volume's SSH config)

5. Additional Configuration#

Available Now (Legacy Regions)#

Public IP Configuration
Security Rules
Cloud-Init Scripts

Coming Soon (Advanced Regions)#

Startup Scripts
Data Volumes
OS Volume Configuration

6. Cost Review#

Review deployment costs before launching. View current pricing.
Legacy Region Cost Breakdown:
Total Hourly Cost = GPU Cost + OS Volume Cost

Components:
- GPU: (GPU Rate × Quantity)
- OS Volume: Fixed 100 GB SSD volume rate (image deployments only)
Costs are calculated in your account's configured currency (USD, EUR, or INR).

Deployment Process#

1
Complete Configuration
Fill all required fields:
GPU model and quantity
Region
Boot source (OS image, volume, or custom image)
SSH key (required for all Legacy region deployments; required for image-based Advanced region deployments; not allowed for volume-based Advanced region deployments)
Optional features (as needed)
2
Review Settings
Verify configuration accuracy:
GPU selection matches requirements
Boot source correctly configured
Costs within budget
3
Submit Deployment
Click "Deploy" to open deployment confirmation modal.
Instance Name Configuration:
Custom Name (Optional): Enter 3-30 characters (letters, numbers, hyphens, underscores). Cannot start or end with hyphen or underscore. Must be unique within your account and region.
Auto-Generated Name: Leave blank to auto-generate. Format: barrack-{gpu}-{random} (e.g., barrack-h100s-abc)
System performs final validation of profile completeness, balance sufficiency, stock availability, and configuration validity.
4
Deployment Execution
Platform creates instance with specified configuration. Deployment typically completes within 2-5 minutes.
5
Access Instance
Once deployed, access your instance:
Instance ID: BRK-XXXXXXD format
IP address (if public IP enabled)
SSH access using configured key
Instance details in dashboard

Post-Deployment#

After successful deployment:
1.
Instance appears in dashboard with status "CREATING"
2.
Status updates to "ACTIVE" when fully provisioned
3.
IP address assigned (if public IP enabled)
4.
SSH access available using configured key
5.
Billing begins immediately upon deployment
6.
Email confirmation sent to account email

Validation and Errors#

Deployment validation occurs at multiple stages.

Common Validation Errors#

Profile Incomplete
Insufficient Credits
Missing Required Fields
Invalid Instance Name
Duplicate Instance Name
Out of Stock
SSH Key Not Found
Volume Not Available
Invalid Script Name

Stock Availability#

GPU stock is validated in real-time during deployment. Stock availability can change between configuration and deployment submission — the system performs final validation immediately before deployment.

API Deployment#

Deploy instances programmatically using our API. View complete endpoint documentation, authentication details, request/response schemas, and code examples in our API Reference.

Support#

Email Support
Technical assistance with deployments: [email protected]
GPU Models
Detailed GPU specifications and selection guide
Boot Source Management
Complete boot source configuration guide
Security Rules
Firewall configuration and rule management
Previous
Bootsource Management
Next
Instance Management
Built with