PricingConsole

Volumes

Last updated 17 November 2026

View .md

A Volume is a disk of your account that one Machine mounts. Your program sees an ordinary ext4 filesystem, from any language, and finds its files where it left them after every sleep and wake, and after the Machine wakes on another server.

What to keep on it

Every wake starts your program fresh: memory, processes and files on the Machine’s own disks are gone (see What comes back). A Volume is where files last: an agent’s working tree, a project and its dependencies, tools you installed, a cache worth keeping warm, an application’s data directory. Mount it at a path, or make it the Machine’s whole disk so that everything you change on the Machine lasts.

A Volume or a database

Keep files on a Volume, and keep records that must not be lost, or that other programs read too, in a Tonbo database. A Machine can have both.

A VolumeA database the Machine binds
What it holdsFiles on an ext4 filesystem, from any languageSQLite tables, from Node.js
Who reaches itThe one Machine it is bound toThe Machine, and any other program of yours that opens it by name; one writer at a time
Where a write is keptOn the disk of the server the Machine runs on, and copied to the region’s storage (see Data guarantees)In three zones of the region, durable once synced() resolves (see When a commit is durable)
Size1 to 100 GiB, fixed when you create itUp to the database limits

How it relates to a Machine

A Volume belongs to your account, not to a Machine. You create it in a region, then bind it to one Machine of that region, at a path or as its whole disk; the Machine gets it at its next wake. While the Machine is awake the Volume is attached to it, and while the Machine sleeps you can move the Volume to another Machine of the region. Deleting the Machine keeps the Volume, unless it was made for that Machine (see Deleting its Machine). You create, list and delete Volumes with tonbo volume or the API, as on Manage Machines.

Tonbo encrypts a Volume’s data on the server and in storage, with a key of its own (see Data protection).

What Tonbo promises

What a write to a Volume survives, a crash, the loss of its server or zone, or a sleep, is Tonbo’s promise on Data guarantees. How Volumes work explains the design behind it.

Use a Volume

Learn more

The tonbo volume commands are in the CLI reference.