Commands

tip

All commands support --help for full flag details, and tab completion is available after installation.

mount

Mount a Volume to a local directory.

mass-ctl mount \
  --volumegroup-label <vg-label> \
  --volume-label <vol-label> \
  -m <mount-point>

Or using UUIDs directly:

mass-ctl mount \
  --pool-uuid <pool-uuid> \
  --container-uuid <container-uuid> \
  -m /mnt/data

Options:

Flag	Description
--volumegroup-label	VolumeGroup label (human-readable)
--volume-label	Volume label (human-readable)
--pool-uuid	VolumeGroup UUID (alternative to label)
--container-uuid	Volume UUID (alternative to label)
-m, --mount-point	Local directory to mount the volume

unmount

Unmount a previously mounted Volume.

mass-ctl unmount -m /mnt/data

volume

Manage Volumes from the CLI.

mass-ctl volume list               # List all volumes
mass-ctl volume list --mine        # List only volumes accessible to your account
mass-ctl volume get <id>           # Show details of a volume
mass-ctl volume create --name <name> --volumegroup <vg-id> --size <bytes> --type posix
mass-ctl volume delete <id>

volumegroup

Manage VolumeGroups from the CLI.

mass-ctl volumegroup list
mass-ctl volumegroup get <id>
mass-ctl volumegroup create --name <name> --label <label> --size <bytes>
mass-ctl volumegroup delete <id>

volume snapshot

Manage snapshots for a Volume.

mass-ctl volume snapshot list <volume-id>
mass-ctl volume snapshot create <volume-id> --name <snapshot-name>
mass-ctl volume snapshot delete <snapshot-id>

volume access / volumegroup access

Manage access policies directly from the CLI (admin only). Use the Dashboard Access → Policies for most access management tasks.

mass-ctl volume access list <volume-id>
mass-ctl volume access grant <volume-id> --identity <identity-id> --permissions read,write
mass-ctl volume access revoke <identity-id> <policy-id>

env

Configure environment variables to optimize I/O performance for the current shell session.

# Optimize for large sequential I/O (max bandwidth)
eval $(mass-ctl env --mode bandwidth)

# Optimize for metadata-intensive workloads
eval $(mass-ctl env --mode metadata)

# Reset to standard settings
eval $(mass-ctl env --mode standard)

Performance guidance:

Mode	Typical throughput	Best for
standard	500–800 MB/s	General workloads
bandwidth	3–5 GB/s	Large file reads/writes, AI training data
metadata	High IOPS	Many small files, checkpointing