Connecting to an NFS Share on the Raspberry Pi?

Accessing files on a Network File System (NFS) server is a useful way to expand storage and share files between computers. The Raspberry Pi’s Linux-based operating system makes mounting an NFS share simple. This guide covers the steps for connecting your Raspberry Pi to an NFS server.

Connecting to an NFS Share on the Raspberry Pi?

What is an NFS Share?

An NFS share is a folder or directory on an NFS server that has been explicitly exported or shared for remote access. Once an NFS share is mounted on a client device like the Raspberry Pi, it appears as just another folder on the client’s file system. NFS handles file transfers in a transparent, seamless way behind the scenes.

Benefits of Connecting to an NFS Share

Some of the benefits of connecting your Raspberry Pi to an NFS share include:

  • Expanded storage – Access to much more storage space than what is available physically on your Raspberry Pi.
  • File sharing – Easy way to share files between devices on a local network.
  • Backups – Central location for backups that is accessible from all devices.
  • Consistency – Files saved directly on an NFS share avoid corruption problems with removable storage like SD cards.


Before connecting your Pi to an NFS share, make sure that:

  • You have an NFS server set up on your local network.
  • The folder you want to access is exported for NFS access on the server.
  • Your Raspberry Pi is on the same local network as the NFS server.

Mounting the NFS Share

With the prerequisites met, mounting the NFS share is done using the Raspberry Pi terminal with the following steps:

  1. Install the NFS client utilities:
  2. bash

sudo apt update

  1. sudo apt install nfs-common
  2. Make a directory that will serve as the mount point, e.g. /mnt/nfs_share:
  3. bash
  4. sudo mkdir /mnt/nfs_share
  5. Mount the NFS share to the new directory:
  6. bash
  7. sudo mount -t nfs /mnt/nfs_share
  8. Where is the IP address of your NFS server and /shared_folder is the exported share.

Once mounted, you can access files on the NFS share at /mnt/nfs_share just like any other folder. Anything written to this folder will be stored directly on the server.

Permanently Mounting on Reboot

By default, the NFS share will be unmounted when the Raspberry Pi reboots. To mount it automatically on startup:

  1. Get the NFS server’s IP and share details:
  2. bash
  3. sudo nfsstat -m
  4. Edit /etc/fstab to add a new NFS mount:
  5.  /mnt/nfs_share  nfs  _netdev 0 0

Now the share will reload after rebooting.

Unmounting and Remounting

To unmount the NFS share:


sudo umount /mnt/nfs_share

Then to remount:


sudo mount /mnt/nfs_share

Just use these same mount and umount commands whenever you need to temporarily access or disconnect from the share.

Optimizing NFS Performance

To maximize transfer speeds, make sure to connect your Pi to your router via Ethernet instead of WiFi. Some additional performance tuning options include:

  • Tweaking cache settings using sudo nfsconf command
  • Limiting number of servers to mount using mntsrvno
  • Adjust read and write packet sizes

Refer to the documentation for your NFS server distribution for details on these advanced options.

Key Takeaways

  • NFS shares provide centralized storage and files sharing
  • Use showmount on the server and nfsstat on the client for info
  • Standard Linux commands like mount, umount and editing /etc/fstab handle connecting and disconnecting NFS shares
  • Fine-tune cache parameters, traffic, and packet sizes for faster transfers

Connecting an external NFS share instantly expands storage for your Raspberry Pi projects. As an open network file sharing protocol, NFS enables simple file access across different operating systems.


Mounting an NFS network share is an easy and versatile way to extend file storage and sharing capabilities for the Raspberry Pi. Following the steps to install dependencies, create a mount point, connect to the server share, and optimize performance, enables seamlessly accessing files stored remotely. NFS is a mature protocol that handles file sharing across platforms, making it widely supported and robust. With storage needs scaling massively for Raspberry Pi projects using sensors, automation and more, leveraging an NFS server removes local SD card constraints allowing Pi innovators to keep creating.

Frequently Asked Questions

Q: What network ports need to be open between the NFS client and server?
A: NFS utilizes port 2049 TCP/UDP for sharing data. Most firewalls open this by default but check rules if you encounter connection issues.

Q: Does connecting over WiFi work for mounting an NFS share with the Pi?
A: Yes, WiFi will work but can be much slower than using a wired Ethernet connection. For best performance, connect the Pi to your local network over Ethernet.

Q: Can I access multiple NFS shares from one Raspberry Pi client?
A: Absolutely. Just create multiple mount points and connect to different exports following the same mount syntax for each one.

Q: What NFS versions does Raspberry Pi OS support?
A: By default, Raspbian has NFSv3 clients support. You can install NFSv4 if needed but most servers still use NFSv3.

Q: Do file permissions and owners transfer via the NFS share?
A: Yes, standard Unix permissions and uid/gid ownership remain unchanged when accessed over an NFS mount.

Q: Can I use SSHFS instead for simpler setup?
A: SSHFS can work but performs worse than NFS in most cases. It also doesn’t integrate permissions and owners as seamlessly.

Q: What is the storage capacity limit when connecting to NFS?
A: There is virtually no limit beyond what your server can hold. Just beware filling SD card storage locally doesn’t mean backups occur to the NFS mount.

Q: How do I know if my NFS mount disconnected unexpectedly?
A: Check using df -h to see your mount points after any reboot or downtime. Also enabling syslog can help troubleshoot disconnect issues.

Q: Does the Raspberry Pi NFS client work with NAS devices like Synology or QNAP?
A: Yes, most networked storage devices support exporting folders over standard NFS for mounting on clients like the Pi.

Q: Can I mount the Raspberry Pi’s own folders as an NFS share?
A: Turning the Pi into an NFS server itself is possible but not recommended, instead use a separate dedicated server for optimal stability.

Q: Is connection speed faster copying files between two Pis on the same network?
A: Generally using NFS is faster as it’s optimized for quick network file transfers rather than copying directly over SSH or Samba.

Q: What issues should I watch out for when relying on an NFS mount for Pi data?
A: Main thing is ensuring redundant power and network to the NFS server for high-availability along with scheduled backups.

Q: Does the Raspberry Pi OS need some special configuration for NFS access to work properly?
A: No, the default Raspbian image enables NFSv3 support out of the box without any extra compilation or kernel module changes needed.

Q: Can I automate connecting to the NFS share from a script or program?
A: Sure, just invoke the mount command from your code to mount the remote NFS share wherever you need it.

Q: Is there a simple one-line command to connect to an NFS export without much setup?
A: Yes, you can run sudo mount.nfs IP:/share /local/mount, avoiding separate install and mount point creation steps.

Q: Does the Raspberry Pi have any size limitations on NFS shares?
A: No, the Pi client handles terabyte+ sized NFS exports just fine. Only constraint is local storage for mount point.

Q: Can I split a large NFS share across multiple mount points on my Pi?
A: Unfortunately no, an NFS export can only be mounted in its entirety to one local mount point.

Q: What type of file systems does the Raspberry Pi support for NFS shares?
A: Common ones like EXT4, XFS, and BTRFS are fully supported. Other more exotic filesystems may lack full compatibility.

Q: Is there a way to get read-only access to files on the NFS share?
A: Yes, add the ro parameter to your mount command to restrict write access and make it read-only.

Q: Can I directly boot the Raspberry Pi from files stored on an NFS share?
A: Sort of – the /boot partition still needs to be on the SD card but the root file system can be mounted over NFS for diskless operation.

Q: What happens to open files or running programs if the NFS share disconnects?
A: Any open files or data not flushed from cache could be lost if connectivity is disrupted unexpectedly to the NFS server.

Q: Is connecting to NFS shares specific to just the Raspberry Pi?
A: No, NFS works for file sharing across nearly any Linux distribution as well as macOS, QNAP, Netgear, and other NAS devices.

Leave a Comment