Running Alluxio Locally


The prerequisite for this part is that you have Java (JDK 7 or above) installed.

Download the binary distribution of Alluxio 1.5.0:

$ wget
$ tar xvfz alluxio-1.5.0-bin.tar.gz
$ cd alluxio-1.5.0

To run in standalone mode, do the following:

  • Set alluxio.master.hostname in conf/ to localhost (i.e., alluxio.master.hostname=localhost).

  • Set alluxio.underfs.address in conf/ to a tmp directory in the local filesystem (e.g., alluxio.underfs.address=/tmp).

  • Turn on remote login service so that ssh localhost can succeed. To avoid the need to repeatedly input the password, you can add the public ssh key for the host into ~/.ssh/authorized_keys. See this tutorial for more details.

Step 0: Format Alluxio Filesystem

NOTE: This step is only required when you run Alluxio for the first time. If you run this command for an existing Alluxio cluster, all previously stored data and metadata in Alluxio filesystem will be erased. However, data in under storage will not be changed.

$ ./bin/alluxio format

Step 1: Start Alluxio Filesystem Locally

Simply run the following command to start Alluxio filesystem.

$ ./bin/ local

NOTE: On Linux, this command may require to input password to get sudo privileges in order to setup RAMFS. If you do not want to type in the password every time, or you do not even have sudo privileges, please read the alternative approaches in FAQ.

Verify Alluxio is running

To verify that Alluxio is running, you can visit http://localhost:19999, or see the log in the logs folder.

To run a more comprehensive sanity check:

$ ./bin/alluxio runTests

You can stop Alluxio any time by running:

$ ./bin/ local


Why is sudo privilege needed to start Alluxio on Linux?

By default, Alluxio filesystem uses RAMFS as its in-memory data storage. On MacOS, it is fine for Alluxio to mount a RAMFS without being a super user. However, on Linux, it requires sudo privileges to perform “mount” (and the followed “umount”, “mkdir” and “chmod” operations).

Can I still try Alluxio on Linux without sudo privileges?

If you have no sudo privileges on Linux, for Alluxio Filesystem to work, it requires a RAMFS (e.g., /path/to/ramdisk) already mounted by the system admin and accessible for read/write-operations by the user. In this case you have can specify the path in conf/


and then start Alluxio with NoMount option to use the above directory as its data storage:

$ ./bin/ local NoMount

Alternatively, you can also specify Linux tmpFS
as the data storage. Tmpfs is a temporary file storage backed by memory (e.g., typically /dev/shm on Linux), but may use SWAP space and therefore provides less performance guarantees compared to ramfs. Similar to using a pre-mounted RAMFS, you can specify the tempfs path in conf/


followed by:

$ ./bin/ local NoMount

How can I avoid typing the password to run sudo?


  • Start Alluxio as a superuser.
  • Add the user to start Alluxio in suderors.
  • Give limited sudo privileges to the running user (e.g., “alluxio”) by adding the following line to /etc/sudoers on Linux: alluxio ALL=(ALL) NOPASSWD: /bin/mount * /mnt/ramdisk, /bin/umount * /mnt/ramdisk, /bin/mkdir * /mnt/ramdisk, /bin/chmod * /mnt/ramdisk This allows Linux user “alluxio” to mount, umount, mkdir and chmod (assume they are in /bin/) a specific path /mnt/ramdisk with sudo privileges without typing the password, but nothing else. See more detailed explanation about Sudoer User Specifications.
Need help? Ask a Question