Mapping CRSP Shares with sshfs

This page illustrates how use sshfs on Linux laptops for accessing CRSP. If you run into issues, contact us via

1. Install sshfs

You will need super user (sudo) rights to install sshfs on your latop.

For CentOS

$ yum -y install sshfs

For Ubuntu or Debian based systems

$ apt-get -y install sshfs

2. Mounting CRSP shares with sshfs

In this example there are two variables:

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

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

If you are a PI and it’s your lab

then both <username> and <labname> are your UCNetID.

If you are added to a PI lab (e.g., you are a student/postdoc in the lab)

then <username> is your UCNetID and <labname> is your PI UCNetID.

From your desktop or laptop, execute the following command replacing <username> and <labname> with the appropriate UCNetIDs:

$ 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> \

As a result, sshfs mounted CRSP share is available under ~/crsp_mount directory

You must be connected to UCINET directly (from the campus) or over UCI VPN to be able to use sshfs.
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 system to your local system. As the campus does not have a centralized directory service to manage every systems, options on how to keep your local system and CRSP accounts synced are very limited.

3. Unmount CRSP shares

$ fusermount -u ~/crsp_mount

4. Using sshfs

Below are some examples on how to use sshfs

  1. Copy a file from your local system to your sshfs mounted drive

    $ cp ~/dir1/file.tar.gz ~/crsp_mount/share/
  2. Recursively copy a directory using rsync from local system to sshfs mounted CRSP share

    $ rsync -rltv ~/dir1 ~/crsp_mount/share/

Please see guides below that provide more information and explain how to get an account, use CRSP and get help:

CRSP Howto Guide

Troubleshooting CRSP Access

Frequently asked questions

LAB allocation

File recovery


CRSP Access

How CRSP is built