How to Mount Remote Linux Filesystem or Directory Using SSHFS Over SSH

The main purpose of writing this article is to provide a step-by-step guide on how to mount remote Linux file system using SSHFS client over SSH.

This article is useful for those users and system administrators who want to mount remote file system on their local systems for whatever purposes. We have practically tested by installing SSHFS client on one of our Linux system and successfully mounted remote file systems.

Before we go further installation let’s understand about SSHFS and how it works.

Sshfs Mount Remote Linux Filesystem or Directory
Sshfs Mount Remote Linux Filesystem or Directory

What Is SSHFS?

SSHFS stands for (Secure SHell FileSystem) client that enable us to mount remote filesystem and interact with remote directories and files on a local machine using SSH File Transfer Protocol (SFTP).

Suggested Read: 10 sFTP Command Examples to Transfer Files on Remote Servers in Linux

SFTP is a secure file transfer protocol that provides file access, file transfer and file management features over Secure Shell protocol. Because SSH uses encryption while transferring files over the network from one computer to another computer and SSHFS comes with built-in FUSE (Filesystem in Userspace) kernel module that allows any non-privileged users to create their file system without modifying kernel code.

In this article, we will show you how to install and use SSHFS client on any Linux distribution to mount remote Linux filesystem or directory on a local Linux machine.

Step 1: Install SSHFS Client in Linux Systems

By default sshfs packages does not exists on all major Linux distributions, you need to enable epel repository under your Linux systems to install sshfs with the help of Yum command with their dependencies.

# yum install sshfs
# dnf install sshfs              [On Fedora 22+ releases]
$ sudo apt-get install sshfs     [On Debian/Ubuntu based systems]

Step 2: Creating SSHFS Mount Directory

Once the sshfs package installed, you need to create a mount point directory where you will mount your remote file system. For example, we have created mount directory under /mnt/tecmint.

# mkdir /mnt/tecmint
$ sudo mkdir /mnt/tecmint     [On Debian/Ubuntu based systems]

Step 3: Mounting Remote Filesystem with SSHFS

Once you have created your mount point directory, now run the following command as a root user to mount remote file system under /mnt/tecmint. In your case the mount directory would be anything.

The following command will mount remote directory called /home/tecmint under /mnt/tecmint in local system. (Don’t forget replace x.x.x.x with your IP Address and mount point).

# sshfs [email protected]:/home/tecmint/ /mnt/tecmint
$ sudo sshfs -o allow_other [email protected]:/home/tecmint/ /mnt/tecmint     [On Debian/Ubuntu based systems]

If your Linux server is configured with SSH key based authorization, then you will need to specify the path to your public keys as shown in the following command.

# sshfs -o IdentityFile=~/.ssh/id_rsa [email protected]:/home/tecmint/ /mnt/tecmint
$ sudo sshfs -o allow_other,IdentityFile=~/.ssh/id_rsa [email protected]:/home/tecmint/ /mnt/tecmint     [On Debian/Ubuntu based systems]

Step 4: Verifying Remote Filesystem is Mounted

If you have run the above command successfully without any errors, you will see the list of remote files and directories mounted under /mnt/tecmint.

# cd /mnt/tecmint
# ls
[root@ tecmint]# ls
12345.jpg                       ffmpeg-php-0.6.0.tbz2                Linux                                           news-closeup.xsl     s3.jpg
cmslogs                         gmd-latest.sql.tar.bz2               Malware                                         newsletter1.html     sshdallow
epel-release-6-5.noarch.rpm     json-1.2.1                           movies_list.php                                 pollbeta.sql
ffmpeg-php-0.6.0                json-1.2.1.tgz                       my_next_artical_v2.php                          pollbeta.tar.bz2

Step 5: Checking Mount Point with df -hT Command

If you run df -hT command you will see the remote file system mount point.

# df -hT
Sample Output
Filesystem                          Type        Size  Used Avail Use% Mounted on
udev                                devtmpfs    730M     0  730M   0% /dev
tmpfs                               tmpfs       150M  4.9M  145M   4% /run
/dev/sda1                           ext4         31G  5.5G   24G  19% /
tmpfs                               tmpfs       749M  216K  748M   1% /dev/shm
tmpfs                               tmpfs       5.0M  4.0K  5.0M   1% /run/lock
tmpfs                               tmpfs       749M     0  749M   0% /sys/fs/cgroup
tmpfs                               tmpfs       150M   44K  150M   1% /run/user/1000
[email protected]:/home/tecmint fuse.sshfs  324G   55G  253G  18% /mnt/tecmint

Suggested Read: 12 Useful “df” Commands to Check Disk Space in Linux

Step 6: Mounting Remote Filesystem Permanently

To mount remote filesystem permanently, you need to edit the file called /etc/fstab. To do, open the file with your favorite editor.

# vi /etc/fstab
$ sudo vi /etc/fstab     [On Debian/Ubuntu based systems]         

Go to the bottom of the file and add the following line to it and save the file and exit. The below entry mount remote server file system with default settings.

sshfs#tecmi[email protected]:/home/tecmint/ /mnt/tecmint fuse.sshfs defaults 0 0

Make sure you’ve SSH Passwordless Login in place between servers to auto mount filesystem during system reboots..

If your server is configured with SSH key based authorization, then add this line:

sshfs#[email protected]:/home/tecmint/ /mnt/tecmint fuse.sshfs IdentityFile=~/.ssh/id_rsa defaults 0 0

Next, you need to update the fstab file to reflect the changes.

# mount -a
$ sudo mount -a   [On Debian/Ubuntu based systems]

Step 7: Unmounting Remote Filesystem

To unmount remote filesystem, jun issue the following command it will unmount the remote file system.

# umount /mnt/tecmint

That’s all for now, if you’re facing any difficulties or need any help in mounting remote file system, please contact us via comments and if you feel this article is much useful then share it with your friends.

If you read this far, tweet to the author to show them you care. Tweet a thanks
Ravi Saive
I am an experienced GNU/Linux expert and a full-stack software developer with over a decade in the field of Linux and Open Source technologies

Each tutorial at TecMint is created by a team of experienced Linux system administrators so that it meets our high-quality standards.

Join the TecMint Weekly Newsletter (More Than 156,129 Linux Enthusiasts Have Subscribed)
Was this article helpful? Please add a comment or buy me a coffee to show your appreciation.

53 thoughts on “How to Mount Remote Linux Filesystem or Directory Using SSHFS Over SSH”

  1. Hi, Thanks for the article.

    When I do mount -a I get message as:

    fuse: mountpoint is not empty
    fuse: if you are sure this is safe, use the ‘nonempty’ mount option

    Can you please help with what this could be?

    Reply
    • Check the /etc/fstab file. There seems to be a directory that is not empty on which you are mounting an FS. With this you could lose the files if the mount goes through.

      Reply
      • Thanks for your reply.

        I am not getting that error now. But now the error is different, after sudo mount -a it’s asking for the remote server’s password 3 times and then getting the message as Connection reset by peer.

        I have enabled the SSH passwordless but still not sure whats the issue is.

        Reply
  2. I have mounted the remote server on my mac. However, there are some mounted paths on the remote server which are not accessible from my mac. How can this be tackled?

    Mounted on Mac using the below command:

    sshfs [email protected]:/ /Users/sgomadi/Desktop/Remote_Dev
    

    Below are the folders in /build which are not accessible.

    sgomadi@sgomadi-a01  ~/Desktop/Remote_Dev/build  ll
    total 152
    lrwxrwxrwx  1 sgomadi  staff    12B Apr 15  2015 apps -> /bldmnt/apps
    lrwxrwxrwx  1 sgomadi  staff    13B Apr 15  2015 cache -> /bldmnt/cache
    lrwxrwxrwx  1 sgomadi  staff    15B Apr 15  2015 current -> /bldmnt/current
    lrwxrwxrwx  1 sgomadi  staff    11B Apr 15  2015 mts -> /bldmnt/mts
    lrwxrwxrwx  1 sgomadi  staff    10B Apr 15  2015 ob -> /bldmnt/ob
    lrwxrwxrwx  1 sgomadi  staff    14B Apr 15  2015 public -> /bldmnt/public
    lrwxrwxrwx  1 sgomadi  staff    15B Apr 15  2015 staging -> /bldmnt/staging
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage14 -> /bldmnt/storage14
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage15 -> /bldmnt/storage15
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage16 -> /bldmnt/storage16
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage17 -> /bldmnt/storage17
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage18 -> /bldmnt/storage18
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage19 -> /bldmnt/storage19
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage20 -> /bldmnt/storage20
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage60 -> /bldmnt/storage60
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 storage61 -> /bldmnt/storage61
    lrwxrwxrwx  1 sgomadi  staff    17B Apr 15  2015 toolchain -> /bldmnt/toolchain
    lrwxrwxrwx  1 sgomadi  staff    13B Apr 15  2015 trees -> /bldmnt/trees
    lrwxrwxrwx  1 sgomadi  staff    12B Apr 15  2015 xfer -> /bldmnt/xfer
    
    Reply
  3. Is it not working with a custom port?

    Already done with passwordless, but on fstab when I save and add some custom port.

    When I type mount -a, it’s always asking for password 3 times and after that I got notice Connection reset by a peer.

    Reply
  4. Hi,

    I am trying to mount a folder from remote Centos machine to my local Ubuntu machine (with SSH based authorization). But on step 6, I am getting parse error.

    Following is my entry in file and then error output on mount :

    sshfs#[email protected]:/home/vagrant/automation/ /mnt/tdc_automn_remote104/ fuse IdentityFile=~/.ssh/id_rsa defaults,allow_other 0 0
    also tried with :
    sshfs#[email protected]:/home/vagrant/automation/ /mnt/tdc_automn_remote104/ fuse IdentityFile=~/.ssh/id_rsa defaults 0 0

    Error :
    TSS\pbisht@punlinvdi160:~$ sudo mount -a
    mount: /etc/fstab: parse error: ignore entry at line 6.

    Any help would be greatly appreciated.
    Thanks

    Reply
  5. Thank you for the article. I have mounted a directory on my worker nodes but when I gave input file path to my Spark program, it gave me error as invalid checkpoint directory. I wanted to know if I want to mount a directory for a cluster with one master node and two worker node what is the correct way of doing it.How should I give path of mounted directory in my Spark program.

    Reply
  6. This article is excellent, thank you very much.

    I did run into one snag on my CentOS 7 server. I have password-less SSH enabled, but when I edited /etc/fstab as instructed it would result in a parse error.

    What ended up working in my case was

    sshfs#[email protected]:/home/tecmint/ /mnt/tecmint fuse defaults, allow_other 0 0

    I hope this helps someone.

    Reply

Got something to say? Join the discussion.

Thank you for taking the time to share your thoughts with us. We appreciate your decision to leave a comment and value your contribution to the discussion. It's important to note that we moderate all comments in accordance with our comment policy to ensure a respectful and constructive conversation.

Rest assured that your email address will remain private and will not be published or shared with anyone. We prioritize the privacy and security of our users.