LogoLogo
Foundry Documentation
Foundry Documentation
  • Welcome to Foundry
  • Quickstart guide
  • Compute & Storage
    • Compute overview
    • Instance types & specifications
    • Reserving compute
    • Spot bids
      • Spot auction mechanics
    • Startup scripts
    • Access & manage instances
      • Statuses
    • Compute quotas
    • Managing open ports
    • Persistent storage
      • File shares
      • Block storage
    • Ephemeral storage
  • Foundry API
    • API overview and quickstart
    • API reference
      • Projects
      • Instance types
      • SSH Keys
      • Volumes
      • Instances
      • Spot
        • Bids
        • Availability
      • API Keys
      • Profile
    • Specification
  • Access Management
    • Access Management Overview
    • SSH keys
  • Account and Billing
    • Billing overview
    • Foundry Referral Program
  • Security & trust
    • Foundry's approach to security
    • Reporting security concerns
Powered by GitBook
LogoLogo

© 2025 Foundry Technologies, Inc.

On this page
  • Provisioning block storage
  • Attach storage to reservations and spot bids
  • Using the disk from your instance
  • Quotas
  1. Compute & Storage
  2. Persistent storage

Block storage

Provision raw disk storage

PreviousFile sharesNextEphemeral storage

Last updated 2 days ago

Block storage requires a quota to be added to your account. For access, contact your account team via Slack or email support@mlfoundry.com.

Block storage gives you the most control over your storage approach by providing a blank disk that can be attached to your instances. Block storage typically requires a more lengthy setup. If you are looking for simple file storage, we recommend using instead.

Provisioning block storage

To provision block storage, go to Storage, select + Create Storage, and select Block.

  1. Select the region you would like to provision your Block storage in.

  2. Select the size for your disk. Currently, each block storage disk has a maximum size of 15TB.

    NOTE: us-central1-a has 15TB and us-central1-b has 7TB of ephemeral storage.

Tip: Give your disks different sizes to make it easier to find the disk you're looking for inside your VM.

Region
GPUs available

us-central1-a

NVIDIA H100

us-central1-b

NVIDIA H100

eu-central1-a

NVIDIA A100

Attach storage to reservations and spot bids

Provisioned storage is available for selection while creating a reservations or spot bid. You can attach as many storage options as needed from the same region. If you select a region that does not have provisioned storage, it will not appear as an option.

For existing instances, you can attach/detach storage volumes when the instances are in a Paused state. You will need to manually mount the new volumes.

Currently, it's not possible to shrink/expand disk size.

Using the disk from your instance

Find the disk device name(s) using lsblk

List your block devices with lsblk. Your selected disks will start from vdd and extend to however many you added in order alphabetically.

$ lsblk
First time only - format the disks

If this is the first time using this disk, you will need to format and define a filesystem. In the below command:

  • Replace /mount/dir/path with the local directory where you want the disk mounted

  • Replace /dev/name with the disk name selected from the output of lsblk

⚠️ Running this command will erase the disk content if previously mounted ⚠️

sudo mkdir -p /mount/dir/path
sudo mkfs.ext4 /dev/name

Repeat this for all disks you are formatting.

Mount the disks

Finally, mount the disk with the below, replacing /dev/name and /mount/dir/path with the local directory of where the disk will be mounted and the disk name

sudo mount -t ext4 /dev/name /mount/dir/path
sudo chown -R $USER:$USER /mount/dir/path

Repeat this for all disks you are mounting.

Persist mounted disks across reboots
  1. Get the UUID of your disks

sudo blkid
  1. Open /etc/fstab in your text editor

sudo vim /etc/fstab
  1. Add the disk to your fstab

# Example template
UUID=DISK_UUID MOUNT_POINT ext4 OPTIONS <dump> <pass> 

It looks something like this. We strongly recommend using the nofail option to prevent instance failure in case of disk failure or disk removal.

UUID=f124a6dc-a10f-4ff4-81cd-6a3990c1aa7d /mnt/disk ext4 defaults,nofail 0 2 
  1. Save and mount

sudo mount -a

Quotas

Each project has a total storage capacity quota that accumulates usage across all regions. Contact your account team via Slack or email support@mlfoundry.com to increase your quota. If you do not see the Storage tab in the main navigation area, please reach out to be whitelisted for this feature.

file share storage