NFS Support!

README.md

@@ -8,7 +8,7 @@ just a stock Ubuntu install, some clever Ansible config and a bunch of Docker co
 ## What This Sets Up
 
 * An awesome dashboard to your home server (Heimdall)
-* Any number of Samba shares for you to store your stuff
+* Any number of Samba shares or NFS exports for you to store your stuff
 * A BitTorrent client
 * Various media management tools - Sonarr, Sickrage, CouchPotato, Radarr
 * Media streaming via Plex or Emby
@@ -19,7 +19,7 @@ just a stock Ubuntu install, some clever Ansible config and a bunch of Docker co
 * A backup tool - allows scheduled backups to Amazon S3, OneDrive, Dropbox etc
 * An IRC bouncer and web-based client
 * Source control with Gitea
-* SSL secured external access to some applications via Traefik
+* SSL secured external access to applications via Traefik
 * A Docker host with Portainer for image and container management
 * An automatic dynamic DNS updater if you use Cloudflare to host your domain DNS
 

docs/configuration/nfs_exports.md

@@ -0,0 +1,13 @@
+# NFS Exports
+
+Ansible-NAS uses the awesome [geerlingguy.nfs](https://github.com/geerlingguy/ansible-role-nfs) Ansible role to configure NFS exports.
+
+More info on configuring NFS exports can be found [here](https://help.ubuntu.com/community/SettingUpNFSHowTo#Shares).
+
+## NFS Examples
+
+Ansible-NAS shares are defined in the `nfs_exports` section within `group_vars/all.yml`. The example provided will allow anyone to read the data in `{{ nfs_shares_root }}/public` on your Ansible-NAS box.
+
+## Permissions
+
+NFS "exports" (an equivalent of a Samba share) are permissioned differently to Samba shares. Samba shares are permissioned with users and groups, and NFS exports are permissioned by the host wanting to access them, and then usual Linux permissions are applied to the files and directories within there. As mentioned above, the example will allow any computer on your network to read and write to the export.

docs/configuration/samba_shares.md

@@ -1,4 +1,4 @@
-# Shares
+# Samba Shares
 
 Ansible-NAS uses the awesome [bertvv.samba](https://github.com/bertvv/ansible-role-samba) Ansible role to configure Samba - check out the project page for the many different options you can use to configure a share.
 

group_vars/all.yml.dist

@@ -193,6 +193,18 @@ samba_shares:
     browsable: yes
     path: "{{ samba_shares_root }}/photos"
 
+###
+### NFS
+###
+# Data you want published over NFS. More info on the nfs config format can be found at
+# https://help.ubuntu.com/community/SettingUpNFSHowTo#Shares
+# WARNING: Weird things might happen if you share the same data over Samba and NFS and allow writes on both!
+
+nfs_shares_root: /mnt/Volume3
+
+nfs_exports:
+  - "{{ nfs_shares_root }}/public *(rw,sync,no_root_squash)"
+
 ###
 ### Cloudflare
 ###

nas.yml

@@ -11,6 +11,11 @@
         - samba
         - skip_ansible_lint
 
+    - role: geerlingguy.nfs
+      tags:
+        - nfs
+        - skip_ansible_lint
+
     - role: geerlingguy.docker
       tags:
         - docker

requirements.yml

@@ -4,3 +4,6 @@
 
 - name: bertvv.samba
   version: v2.7.0
+
+- name: geerlingguy.nfs
+  version: 1.5.0