Mapping CRSP Shares with sshfs

Table of Contents

This section illustrates how to map CRSP share(s) with sshfs. Follow the instructions below to install sshfs ( if not installed ) and mount CRSP shares with sshfs.

1. Mapping New CRSP (or other) Shares with sshfs in Linux

1.1. Install sshfs ( if not installed )

  • For CentOS

    $ yum -y install sshfs
  • For Ubuntu or Debian based systems

    $ apt-get -y install sshfs

    Note: You will need super user(sudo) rights to install sshfs

1.2. Mounting CRSP shares with sshfs

In this example there are two variables:

  • <username> - this is the UCNetID of an authorized user on CRSP

  • <labname> - this is the UCNetID of the lab in which the user has access

From your desktop or laptop, replace <username> with your UCNetID and replace <labname> with the name of the lab that you want to access:

$ cd ~
$ mkdir crsp_mount # or some other name of your choice
$ sshfs -o ssh_command='ssh -A -X -o StrictHostKeyChecking=no' -o idmap=user \
  <username><labname> ~/crsp_mount
If you are a PI and it’s your lab, then <username> and <labname> should be the same (your UCNetID). If you have been added to a PI’s lab (e.g., you are a student or a postdoc in the lab), <username> is your UCNetID and <labname> is your PI’s UCNetID.
You must be connected to UCINET directly ( from the campus ) or over UCI VPN to be able to use sshfs. CRSP service is not avaiable outside the UCI network.
SSHFS will not automatically map all your remote UID and GID from all of your CRSP groups in your local Linux system. So, follow the command above and note the '-o idmap=user' option. This will only present your primary UID/GID from the remote(CRSP) systemt to your local system. As the campus does not have a centralized directory service to maange every systems, CRSP teams options are very limited on how to keep your local system and CRSP accounts synced.

If you run into issues with SSHFS, don’t be alarmed, we are here to help! Email us at, we will be happy to help you out!

1.3. Unmouting CRSP shares

$ fusermount -u ~/crsp_mount

1.4. Using sshfs

Below are some examples on how to use sshfs

  • Copy from your local system to your sshfs mounted drive

    $ cp ~/home/file.tar.gz ~/crsp_mount/share/
  • rsync a directory from local system to sshfs mounted CRSP share

    $ rsync -rlptD ~/home/dir1 ~/crsp_mount/share/