Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Tutorial for mountaing Unraid NFS share to Ubuntu Server?

Featured Replies

Unraid 7.1.4

I have an SMB share to allow connecting to my Unraid share from a Windows PC (attached).

I would like to mount my Unraid array to my Ubuntu Server to be able to read/write to it.

Apologies for the beginner questions:

  1. Do I create a new share in Shares > Add Share, or is there a way for a share to support both SMB and NFS?

  2. Is the best way to create a shared drive through Unassigned Devices?

  3. Should I delete my share from Shares and create the SMB/NFS share through Unassigned Devices instead?

  4. Should I use Unassigned Devices or Unassigned Devices Plus?

  5. It seems like Unassigned Devices is creating a share from a remote server to the Unraid server. I am trying to do the reverse. What's the best way to do this?

  6. This guide seems to suggest some settings for the client side mount parameters, so would this go in /etc/fstab?
    192.168.0.30:/mnt/user/unraid /my_ubuntu_server/unraid nfs hard,timeo=50,retrans=5,relatime,rsize=1048576,wsize=1048576

Thanks in advance for the tips!

Screenshot 2026-01-26 at 2.18.54 PM.png

Solved by bmartino1

  • Solution

Thata looks good...

Configure NFS on Unraid

On Unraid (GUI):

  1. Settings → NFS

    • Enable NFS: Yes

    • Apply

  2. Shares → YourShareName

    • Set Export: Yes

    • Security (recommended):

      • Private

      • Rule example:

        <ubuntu_ip>(rw,sec=sys,async,no_subtree_check)
        
    • Apply

💡 If testing, you can temporarily use Public to rule out permission issues...



First UBUNTU...

Install NFS client on Ubuntu Server

sudo apt update
sudo apt install -y nfs-common

Verify:

mount.nfs --version

Next selcet a path on ubuntu to mount the nfs... lets use /mnt simlar to what unraid does...

Create a mount point

Pick where you want the share mounted:

sudo mkdir -p /mnt/unraid
sudo chown root:root /mnt/unraid
sudo chmod 755 /mnt/unraid

(You can adjust ownership later if a non-root user needs access.) this is ubuntu user and access to the folder stuff...

Test the NFS export (important)

List available exports from Unraid:

showmount -e <UNRAID_IP>

You should see something like:

/mnt/user/media

this would be the path to your unriad host that is being shared...

If this fails → firewall, NFS not enabled, or export misconfigured...

Manual mount (test before fstab)

sudo mount -t nfs <UNRAID_IP>:/mnt/user/YourShareName /mnt/unraid

Verify:

df -h | grep unraid
ls /mnt/unraid

If this fails, stop here—don’t touch /etc/fstab yet. To make it permeant upon ubnut reboots to auto conect the share

Fix permissions (very common gotcha)

Unraid typically uses:

  • UID 99 (nobody user)

  • GID 100 (Users group)

Check on Ubuntu:

ls -ln /mnt/unraid

If you see permission issues, either:

Option A — match UID/GID (recommended for servers)

sudo usermod -u 99 youruser
sudo groupmod -g 100 yourgroup

Option B — force UID/GID in mount options

(Useful for Docker hosts)

sudo umount /mnt/unraid
sudo mount -t nfs -o rw,vers=3,hard,timeo=600,retrans=5 <UNRAID_IP>:/mnt/user/YourShareName /mnt/unraid

Persistent mount via /etc/fstab

Edit ubuntu cofig:

sudo nano /etc/fstab

Add one of these (recommended options shown):

Stable & compatible (best default)

<UNRAID_IP>:/mnt/user/YourShareName  /mnt/unraid  nfs  rw,vers=3,hard,_netdev,noatime  0  0

If you know you want NFSv4

<UNRAID_IP>:/mnt/user/YourShareName  /mnt/unraid  nfs4 rw,hard,_netdev,noatime  0  0

Apply without reboot:

sudo mount -a

Validate after reboot of ubuntu

reboot
df -h
mount | grep nfs

Other side errors and fixes:

Common fixes if something breaks

mount.nfs: access denied

  • Share not exported

  • IP not whitelisted

  • Wrong export path (/mnt/user/... vs /mnt/diskX/...)

Hangs at boot

  • Missing _netdev in fstab

  • Network not ready yet

  • Author

This is an absolutely amazing tutorial and incredibly well formatted!

A few questions I have along the way.

Configure NFS on Unraid

From this guide, I have set the rule to (attached):

*(async,no_subtree_check,rw,sec=sys,insecure,anongid=100,anonuid=99,no_root_squash)

Does the <star> replace the <ubuntu_ip> in your example? Should I specify the <ubuntu_ip> instead?

NFS Version

> mount.nfs --version
mount.nfs: (linux nfs-utils 2.6.4)

Test NFS Export

Does this look good?

> showmount -e 192.168.0.30
Export list for 192.168.0.30:
/mnt/user/unraid *

Manual Mount Test

> df -h | grep unraid
192.168.0.30:/mnt/user/unraid      219T  191T   28T  88% /mnt/unraid
> ll /mnt/unraid
drwxrwxrwx 1   99   207 Dec  4  2023  .
drwxr-xr-x 3 root  4096 Jan 27 01:04  ..
drwxrwxrwx 1   99  4096 Dec 20 22:41  Movies
drwxrwxrwx 1   99  4096 Nov 16 07:54  Shows

Check Permissions

Does this look good?

> ls -ln /mnt/unraid
drwxrwxrwx 1 99 100 4096 Dec 20 22:41  Movies
drwxrwxrwx 1 99 100 4096 Nov 16 07:54  Shows

Create /etc/fstab Entry

From this guide, it recommends the following mount parameters:

hard,timeo=50,retrans=5,relatime,rsize=1048576,wsize=1048576

Are these mount parameters okay? It looks like you have several other parameters as well, so should I combine these parameters into this:

rw,vers=3,hard,_netdev,noatime,hard,timeo=50,retrans=5,relatime,rsize=1048576,wsize=1048576

In Unraid > Settings > NFS > Max Server Protocol Version, should I set this to NFSv3? I really don't know what NFSv4 is or when to use it, but I am on the latest Ubuntu Server 24.04.3.

Screenshot 2026-01-26 at 5.02.33 PM.png

@bmartino1 any thoughts on the mount parameters?

Edited by raphytaffy

  • 4 weeks later...

that looks good to me/ sorry forthe late reply. my usualy form feed didn't show a update to this topic.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.