Volumes for agents

Attach Blaxel Volumes to agents for persistent storage that survives redeployments, configured via blaxel.toml or the Blaxel console.

Blaxel Volumes provide persistent storage that persists across agent redeployments.

For full documentation on creating, deleting, resizing, and listing volumes, see the Volumes overview.

Attach a volume to an agent

You must create a volume before attaching it to an agent.

To use a volume with an agent, add a [[volumes]] entry to your blaxel.toml and pin the agent to a specific region matching the volume’s region.

# blaxel.toml

type = "agent"
name = "my-agent"

# Required when attaching volumes — the agent must be in the same region as the volume
region = "us-pdx-1"

[[volumes]]
name = "my-volume"      # Must match the name of the created volume
mountPath = "/data"     # Directory inside the agent container

Then deploy (or redeploy) your agent:

bl deploy

The volume will be mounted at the specified path inside your agent’s container. Any files written there will persist across redeployments.

Learn more about volumes

Learn how to create and manage volumes.

Learn more about volume templates

Pre-populate volumes with files for faster environment setup.