Skip to main content

Setting up the VAST NFS driver

Shared Disks are mounted over NFS. Before mounting a Shared Disk on a VM for the first time, verify that the VAST NFS driver is installed on that VM. If your VM was created after Dec 2025, the driver is likely already installed in the VM image.

Verify the driver is installed​

Run vastnfs-ctl status on the VM:

ubuntu@<vm>:~$ vastnfs-ctl status
version: 4.0.35-vastdata
kernel modules: sunrpc
services: rpcbind.socket rpcbind
rpc_pipefs: /run/rpc_pipefs

If the command fails with command not found, follow the install steps below.

Install the driver on a single VM​

Use the Python installer published by Crusoe:

wget -O crusoe_shared_disks_nfs_setup.py https://github.com/crusoecloud/crusoe-nfs-support/raw/refs/heads/main/crusoe_shared_disks_nfs_setup.py
python3 crusoe_shared_disks_nfs_setup.py --apply-network-optimizations --apply-read-ahead-cache
info

--apply-network-optimizations sets the MTU to 9000 and applies ring-buffer optimizations. --apply-read-ahead-cache increases the NFS readahead cache from the Linux default of 128KB to 16MB. Both flags are recommended for best performance.

Install on multiple VMs with pssh​

To apply the installer across many VMs at once, use pssh.

Install pssh on a Mac:

brew install pssh

Install pssh on Linux:

sudo apt install pssh

Create a file named hosts.txt listing the VMs, one per line:

ubuntu@<IP1>
ubuntu@<IP2>
info

Ensure SSH connectivity is set up between your workstation and each VM before running the commands below.

On a Mac (uses pscp / pssh):

pscp -h hosts.txt crusoe_shared_disks_nfs_setup.py /home/ubuntu/crusoe_shared_disks_nfs_setup.py
pssh -t 0 -h hosts.txt "export DEBIAN_FRONTEND=noninteractive && python3 /home/ubuntu/crusoe_shared_disks_nfs_setup.py --apply-network-optimizations --apply-read-ahead-cache -y"

On Linux (uses parallel-scp / parallel-ssh):

parallel-scp -h hosts.txt crusoe_shared_disks_nfs_setup.py /home/ubuntu/crusoe_shared_disks_nfs_setup.py
parallel-ssh -t 0 -h hosts.txt "export DEBIAN_FRONTEND=noninteractive && python3 /home/ubuntu/crusoe_shared_disks_nfs_setup.py --apply-network-optimizations --apply-read-ahead-cache -y"

Once the driver is installed on all VMs, proceed to Mounting Shared Disks.