Commands

volume

Manage network volumes and move files in and out of them from your terminal.

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.

Create a volume

featherless-cloud volume create datasets --gb 500 --wait
OptionDescription
--gb <n>Capacity, 10–10,240. Default 100.
--waitWait up to about 30 seconds for the volume to become usable.

Show a volume

featherless-cloud volume get datasets

Prints its status, capacity, usage, price and the instances using it.

Change a volume

featherless-cloud volume update datasets --gb 1000
featherless-cloud volume update datasets --name training-data
OptionDescription
--name <name>New name.
--gb <n>New capacity. It can only grow.

Delete a volume

featherless-cloud volume delete datasets

Deletes the volume and all its files. Instances using it must be stopped first.

OptionDescription
--yesSkip the confirmation.

List files

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.

OptionDescription
-h, --human-readableSizes like 1.5 KiB instead of bytes.
-r, --recursiveEverything below the folder.
--summarizeEnd with the number of files and their total size.

Find files

featherless-cloud volume find vol://datasets --name "*.safetensors" --size +1G -l -h
featherless-cloud volume find vol://datasets/tmp --type f --older-than 30d
OptionDescription
--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, --longPrint modification time and size.
-h, --human-readableWith -l, readable sizes.
-0, --print0End each path with a NUL, for xargs -0.

Copy files

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.

OptionDescription
-r, --recursiveCopy folders and everything in them.
--overwriteReplace files that already exist.
--updateSkip files whose size and modification time already match.
--concurrency <n>Files at a time, 1–32. Default 16.
--dry-runShow what would be copied.
-v, --verbosePrint each file.
--progressShow a running total.

Move files

featherless-cloud volume mv vol://datasets/tmp/run1 vol://datasets/runs/
OptionDescription
--overwriteReplace files at the destination.
--concurrency <n>Files at a time, 1–32. Default 16.
-v, --verbosePrint each file.
--progressShow a running total.

Sync a folder

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.

OptionDescription
--mode <upload|download|both>Direction. Default both.
--dry-runShow what would be sent and received.
--mkdirsCreate missing folders on either side.
--forceSend 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, --verbosePrint each file.
--progressShow a running total.

Create folders

featherless-cloud volume mkdir -p vol://datasets/runs/2026-11
OptionDescription
-p, --parentsCreate missing parent folders.

Delete files

featherless-cloud volume rm vol://datasets/old.bin
featherless-cloud volume rm -r vol://datasets/tmp
OptionDescription
-r, --recursiveDelete folders and everything in them.
--yesSkip the confirmation.