.. _network_file_access:

Please help me make this page better! Send recommendations to support-neuro@berkeley.edu.

.. index::
   single: sshfs


==================
Mount cluster data
==================
You may mount data from the Neuro Cluster to your desktop. That way, you can use software on your local computer with data from the neuro cluster.

-----
SSHFS
-----
SSHFS is a program to access remote data securely, available for Mac and linux. If you have a Windows OS, please contact me for documentation and assistance.

.. _commandline:

#. If you're using a Mac, install both MacFUSE and SSHFS from from `osxfuse.github.io <http://osxfuse.github.io/>`_. 

#. If you haven't done so already, enable :ref:`2-step authentication<mfa>`

#. Open a terminal window and create a local folder to mount data from the neuro cluster, for example::

        mkdir /tmp/neurocluster-home

#. Mount the Neuro cluster directory via sshfs using the syntax::

        sshfs -o idmap=user <username>@<servername>:<remote_directory> <mount_point>

   For example,::

        sshfs -o idmap=user me@nx2.neuro.berkeley.edu:/home/jagust/me /tmp/neurocluster-home

#. If you get timeout errors, you may add additional options::

        sshfs -o idmap=user,reconnect,ServerAliveInterval=15,uid=$(id -u),gid=$(id -g),ServerAliveCountMax=3 <username>@<servername>:<remote_directory> <mount_point>

#. when you're finished, unmount the local directory with the 'fusermount -u' command, for example::

        fusermount -u /tmp/neurocluster-home