mass-ctl Command Cheat Sheet

Configuration & Authentication

# Set endpoint
mass-ctl config set manager-endpoint https://IP:30083

# Login
mass-ctl login
mass-ctl login --validity-hours 168
mass-ctl login --auto-renew

# Logout / version
mass-ctl logout
mass-ctl --version

Mount & Unmount

# Mount
sudo mass-ctl mount --volume-id VOL -m /mnt/data
sudo mass-ctl mount --volume-id VOL -m /mnt/data --read-only
# Temporary mount that does not survive a reboot (no root needed)
mass-ctl mount --volume-id VOL -m /mnt/data --no-fstab

# Shared mount for every user on the host
sudo mass-ctl mount --volume-id VOL -m /mnt/data --allow-other

# Unmount
sudo mass-ctl unmount -m /mnt/data

# Verify mount
df -h /mnt/data
ls /mnt/data

info

Mounting registers reboot recovery by default, so a mount comes back automatically after a reboot. --fstab is deprecated and now a no-op.

Data Copy & Tuning

# Bulk copy into a mounted volume
mass-ctl dsync --source /data/legacy --target /mnt/data/incoming

# Tune the shell for the workload
eval $(mass-ctl env --bandwidth)
eval $(mass-ctl env --metadata)