The volume commands create, resize and delete network volumes, and copy, sync, find and organize the files in them.
featherless-cloud volume <subcommand> [options]
Files in a volume are written vol://<volume>/<path>. Every other path is on your computer.
featherless-cloud volume create datasets --gb 500 --wait
| Option | Description |
|---|---|
--gb <n> | Capacity, 10–10,240. Default 100. |
--wait | Wait up to about 30 seconds for the volume to become usable. |
featherless-cloud volume get datasets
Prints its status, capacity, usage, price and the instances using it.
featherless-cloud volume update datasets --gb 1000
featherless-cloud volume update datasets --name training-data
| Option | Description |
|---|---|
--name <name> | New name. |
--gb <n> | New capacity. It can only grow. |
featherless-cloud volume delete datasets
Deletes the volume and all its files. Instances using it must be stopped first.
| Option | Description |
|---|---|
--yes | Skip the confirmation. |
featherless-cloud volume ls
featherless-cloud volume ls -h vol://datasets/train
featherless-cloud volume ls -r --summarize vol://datasets/train
With no path, ls lists your volumes.
| Option | Description |
|---|---|
-h, --human-readable | Sizes like 1.5 KiB instead of bytes. |
-r, --recursive | Everything below the folder. |
--summarize | End with the number of files and their total size. |
featherless-cloud volume find vol://datasets --name "*.safetensors" --size +1G -l -h
featherless-cloud volume find vol://datasets/tmp --type f --older-than 30d
| Option | Description |
|---|---|
--name <pattern> | Names matching a pattern: * any characters, ? one, [abc] one of those. |
--iname <pattern> | Like --name, ignoring case. |
--type <f|d> | Only files or only folders. |
--maxdepth <n> | How many levels below the folder to look. |
--size <+n|-n> | Bigger (+) or smaller (-) than a size like 10G or 512K. Repeat for a range. |
--newer-than <age> | Modified within an age like 30m, 12h or 7d. |
--older-than <age> | Modified longer ago than an age. |
-l, --long | Print modification time and size. |
-h, --human-readable | With -l, readable sizes. |
-0, --print0 | End each path with a NUL, for xargs -0. |
featherless-cloud volume cp -r ./weights vol://datasets/models/
featherless-cloud volume cp vol://datasets/models/out.bin .
featherless-cloud volume cp -r vol://datasets/models vol://archive/
cp works in either direction and between volumes. An interrupted copy resumes when you run it again. A destination ending in /, or an existing folder, receives each source under its own name.
| Option | Description |
|---|---|
-r, --recursive | Copy folders and everything in them. |
--overwrite | Replace files that already exist. |
--update | Skip files whose size and modification time already match. |
--concurrency <n> | Files at a time, 1–32. Default 16. |
--dry-run | Show what would be copied. |
-v, --verbose | Print each file. |
--progress | Show a running total. |
featherless-cloud volume mv vol://datasets/tmp/run1 vol://datasets/runs/
| Option | Description |
|---|---|
--overwrite | Replace files at the destination. |
--concurrency <n> | Files at a time, 1–32. Default 16. |
-v, --verbose | Print each file. |
--progress | Show a running total. |
featherless-cloud volume sync --dry-run ./weights vol://datasets/models
featherless-cloud volume sync ./weights vol://datasets/models
featherless-cloud volume sync --mode download --mkdirs ./results vol://datasets/results
sync sends what changed on each side since the last sync and never deletes. The folder must exist on both sides unless you pass --mkdirs. A file changed on both sides is a conflict: sync reports it and exits with code 1. Choose a side with --mode upload --force or --mode download --force.
| Option | Description |
|---|---|
--mode <upload|download|both> | Direction. Default both. |
--dry-run | Show what would be sent and received. |
--mkdirs | Create missing folders on either side. |
--force | Send even when the chosen side is older. Needs --mode upload or --mode download. |
--include <glob> | Only paths matching a glob. Repeatable. |
--exclude <glob> | Skip paths matching a glob. Repeatable. |
--concurrency <n> | Files at a time, 1–32. Default 16. |
-v, --verbose | Print each file. |
--progress | Show a running total. |
featherless-cloud volume mkdir -p vol://datasets/runs/2026-11
| Option | Description |
|---|---|
-p, --parents | Create missing parent folders. |
featherless-cloud volume rm vol://datasets/old.bin
featherless-cloud volume rm -r vol://datasets/tmp
| Option | Description |
|---|---|
-r, --recursive | Delete folders and everything in them. |
--yes | Skip the confirmation. |