Configuring Alluxio with NFS

Slack Docker Pulls GitHub edit source

This guide describes how to configure Alluxio with NFS as the under storage system.

Initial Setup

First, the Alluxio binaries must be on your machine. You can either compile Alluxio, or download the binaries locally.

Then, if you haven’t already done so, create your configuration file with bootstrapConf command. For example, if you are running Alluxio on your local machine, <ALLUXIO_MASTER_HOSTNAME> should be set to localhost in the following command:

./bin/alluxio bootstrapConf <ALLUXIO_MASTER_HOSTNAME>

Alternatively, you can also create the configuration file from the template and set the contents manually.

cp conf/ conf/

Configuring Alluxio

Assuming the NFS clients are co-located with Alluxio nodes, all the NFS shares are mounted at directory /mnt/nfs, the following environment variable assignment needs to be added to conf/


Running Alluxio with NFS

After everything is configured, you can start up Alluxio locally to see that everything works.

./bin/alluxio format
./bin/ local

This should start an Alluxio master and an Alluxio worker. You can see the master UI at http://localhost:19999.

Next, you can run a simple example program:

./bin/alluxio runTests

After this succeeds, you can visit your NFS volume to verify the files and directories created by Alluxio exist. For this test, you should see files named like:


To stop Alluxio, you can run:

./bin/ all