Out Plane
volume

volume

The volume commands.

A volume is a disk that survives deployments. An application that has to keep something, an uploads directory or a database it runs itself, needs one.

Two facts shape everything else here. A mount reaches the running application at its next deployment rather than immediately, and detaching a disk is not deleting it: the contents and the cost stay until it is destroyed.

Commands

CommandWhat It DoesRisk
volume listList the team's disks.read
volume getShow one disk.read
volume createCreate a disk, and optionally mount it.write
volume attachMount a disk on an application.write
volume detachUnmount a disk, keeping it and its contents.write
volume deletePermanently destroy a disk and its contents.destructive

On this page