TrueNAS SCALETrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

NFS Services Screen

The System > Services screen includes two icons on the NFS service row:

The UDP protocol is deprecated and not supported with NFS. It is disabled by default in the Linux kernel. Using UDP over NFS on modern networks (1Gb+) can lead to data corruption caused by fragmentation during high loads.

NFS Service Screen

The Services > NFS configuration screen displays settings to customize the TrueNAS NFS service.

You can access it from System > Services screen. Locate NFS and click to open the screen, or use the Config Service option on the Unix (NFS) Share widget options menu found on the main Sharing screen.

Select Start Automatically to activate the NFS service when TrueNAS boots.

NFS Service Settings
Figure 1: NFS Service Settings

General Options Settings

SettingDescription
Bind IP AddressesSelect IP addresses to listen to for NFS requests. Leave empty for NFS to listen to all available addresses. You must configure static IPs on the interface for them to appear on the dropdown list.
Calculate number of threads dynamicallyAutomatically sets the number of threads used by the kernel NFS server.
Specify number of threads manuallyShows after deselecting Calculate number of threads dynamically. Enter an optimal number of threads used by the kernel NFS server.

NFSv4 Settings

SettingDescription
Enabled ProtocolsSelect NFSv3, NFSv4, or both. If NFSv4 is selected, NFSv3 ownership model for NFSv4 clears, allowing you to select or leave it clear.
NFSv4 DNS DomainSelect to use the value to override the default DNS domain name ofr NFSv4. Speicifies the domain idmapd.conf setting.
NFSv3 ownership model for NFSv4Becomes selectable after selecting NFSv4. Select when you need NFSv4 ACL support without requiring the client and the server to sync users and groups. Selecting this deactivates the Manage Groups Server-side option.
Require Kerberos for NFSv4Select to force NFS shares to fail if the Kerberos ticket is unavailable.

Ports Settings

SettingDescription
mountd(8) bind portEnter a port to bind mountd(8).
rpc.statd(8) bind portEnter a port to bind rpc.statd(8).
rpc.lockd(8) bind portEnter a port to bind rpc.lockd(8).

Other Options Settings

SettingDescription
Serve UDP NFS clientsSelect if NFS clients need to use the User Datagram Protocol (UDP).
Allow non-root mountOnly select if required by the NFS client to allow serving non-root mount requests.
Manage Groups Server-sideThis option allows the server to determine group IDs based on server-side lookups rather than relying solely on the information provided by the NFS client. This can support more than 16 groups and provide more accurate group memberships. Equivalent to the --manage-gids flag for rpc.mountd.

We recommend using the default NFS settings unless you require specific settings. When TrueNAS is already connected to Active Directory, setting NFSv4 and Require Kerberos for NFSv4 also requires a Kerberos Keytab.