This box searches only documentation in the Data Store space. To search the entire CyVerse wiki, use the box at the upper right.

For overview information, see Data Store or Manage Data on the CyVerse website.





Skip to end of metadata
Go to start of metadata

FUSE is useful for viewing and navigating directories and directory contents, and provides the ability to mount a storage device in a UNIX/Linux environment as a directory. The CyVerse Data Store has a new optimized FUSE client, which allows you to mount a Data Store directory to a local directory. Most Atmosphere images use FUSE.

Steps for using the Data Store FUSE client for RHEL/CentOS systems are available below; however, other Linux and Mac distributions will have similar steps.

Step 1: Install FUSE and the Data Store FUSE client

The steps for installing the new optimized FUSE client, available below, depend on whether you use FUSE with Atmosphere. You may continue to use a previous installation, although you may need to upgrade, depending on the version that is installed on your system:

  • If using version < 3, upgrade is required (Mac OS and Solaris: upgrade to 3.2 required).
  • If using version 3.0 to 4.1.9, upgrade is recommended. 

If using FUSE with Atmosphere

Since all Atmosphere images come with FUSE installed, go to Setting Up iCommands, then return here to complete your setup. Installing the optimized FUSE client is not required for Atmosphere FUSE users.

If not using FUSE with Atmosphere, install the optimized FUSE client

If running CentOS 6 or 7

If you are running CentOS 6 or 7, the FUSE dependencies need to be installed. Use the following command to install packages for the dependencies:

Choose one of the following installer packages (note that these have not been fully tested):

Step 2: Configure your Data Store environment and log in

If you have not already done so, configure your iCommands settings.

Step 3: Select where to mount your home directory

You can mount your Data Store home directory anywhere your account has access on your local system. For convenience, it is recommended that you mount your Data Store home directory to an easily accessible location, such as $HOME/data_home, or something similar:

Note: If you select a different directory to mount your Data Store directory, be sure that your user has ownership of that directory.

Step 3a (OPTIONAL): Select the Data Store directory to mount

Only for Advanced Users


This step is for advanced users; most users should skip this step.

To choose the Data Store directory to mount onto your system, icd into the directory before proceeding to Step 4.

Step 4: Mount the Data Store directory

  1. Mount the directory for all system users:

    If you get the error, "fusermount: option allow_other only allowed if 'user_allow_other' is set in /etc/fuse.conf", use the following command and reenter the irodsFs command:

Step 5: Unmount the directory when finished

To unmount the directory when you are done, use the following command:

Helpful Links

On this page:

Related pages:


  1. Step 5 does not work for me because /usr/bin/fusermoun does not exist

    cardenaj@vm142-53:~$ /usr/bin/fusermount -u /home/cardenaj/data

    -bash: /usr/bin/fusermount: No such file or directory

    1. The wiki page isn't too clear, but it assumes that you have installed iCommands.  If you followed the one of the links under 'If not using FUSE with Atmosphere, install the optimized FUSE client', it would have you install the fuse package. This package provides fusermount.  We are planning on updating the wiki soon with less confusing instructions.  I'm sorry for the confusion.

  2. HI Julio Cardenas. I've updated the page. Hope this helps! ~Kathleen