Skip to main content
Volumes provide persistent block storage that survives VM restarts and redeployments. Use them for databases, file uploads, caches, or any data that needs to persist.

Create a volume

zwrm volumes create <name>
FlagTypeDefaultDescription
--sizeint1024Volume size in MB
--mountstring/dataMount point inside the VM
--appstringfrom zwrm.tomlApplication name
--no-syncboolfalseDon’t update zwrm.toml
By default, creating a volume also adds it to your zwrm.toml file.

Example

zwrm volumes create uploads --size 5120 --mount /app/uploads
This creates a 5 GB volume mounted at /app/uploads in your VM.

List volumes

zwrm volumes list
Shows volume ID, name, total size, used space, free space, and mount point.

Destroy a volume

zwrm volumes destroy <name>
FlagTypeDefaultDescription
--force, -fboolfalseSkip confirmation prompt
--no-syncboolfalseDon’t update zwrm.toml
Destroying a volume permanently deletes all data on it. This cannot be undone.

Check volume limits

zwrm volumes limits
Shows maximum volume size, per-app volume limits, minimum free disk, and available disk space.

Defining volumes in zwrm.toml

You can also define volumes directly in your configuration file:
[[volumes]]
name = "data"
size_mb = 10240
mount_point = "/data"
Volumes defined in zwrm.toml are created automatically on deploy if they don’t already exist.