Troubleshooting

Mount fails with "permission denied"

• Run mass-ctl login (or sudo mass-ctl machine register) to obtain a valid certificate
• Verify your identity is registered and ACTIVE in the Dashboard under Access → Users or Access → Machines
• Check that an AccessPolicy grants read/write permissions on the target volume

Certificate expired

• Run mass-ctl login again to renew your user certificate
• Machine certificates (machine register) are long-lived and rarely expire

Low throughput after mount

• Run eval $(mass-ctl env --mode bandwidth) in your shell before starting the workload
• Ensure the network interface is configured with jumbo frames (MTU 9000) for Ethernet fabrics

command not found: mass-ctl

• Ensure the mango-boostx-ctl package is installed on the client machine (not just the server)