Skip to Content
Open Beta — managed Kubernetes, DNS & more are live.
📁

NFS file shares

Updated 2026-11-20
On this page

NFS file shares

An NFS file share is a shared file system that many instances can mount and use at the same time, so a fleet of servers reads and writes the same files over the network.

Where a block volume attaches to a single instance, a file share is built for concurrent access. Mount it on several web servers, application nodes or workers and they all see the same directory tree, which is ideal for shared uploads, content, configuration and build artifacts.

You control who can mount a share with access rules, and you place shares on your private network through a share network so only your instances can reach them. Shares can be resized as your data grows.

Screenshot — The Storage > NFS shares list showing shares with their size and status
The Storage > NFS shares list showing shares with their size and status

Key concepts

Share — A shared file system exported over NFS that multiple instances can mount at once.

Share network — The private network a share is attached to so your instances can reach it.

Access rule — A grant that permits a client (by IP) to mount the share, read-only or read-write.

Export path — The address and path you mount, shown on the share's detail page.

Before you start

  • A private network to attach the share to (a share network).
  • One or more instances on that network to mount the share.
  • Enough file-share quota in the project.
  • The nfs-common client package installed on each instance.

Step by step

  1. Create a share

    Go to Storage > NFS shares and choose Create share; set a name, a size and the share network to place it on.

    Screenshot — The Create share form with the size and share-network fields
    The Create share form with the size and share-network fields
  2. Wait until it is available

    The share becomes ready within a short time and gets an export path you will mount.

  3. Grant access

    Open the share and add an access rule for each client IP that should mount it, choosing read-only or read-write.

    Screenshot — The access-rules panel with a rule granting an instance read-write access
    The access-rules panel with a rule granting an instance read-write access
  4. Find the export path

    Copy the export path from the share's detail page; it is what you pass to the mount command.

    Screenshot — The share detail page showing the export path
    The share detail page showing the export path
  5. Mount it on your instances
    • Install the NFS client if needed.
    • Create a mount point and mount the export path.
    • Add it to /etc/fstab to remount on reboot.

Examples

Mount a share (Linux)
sudo apt-get install -y nfs-common
sudo mkdir -p /mnt/shared
# use the export path shown on the share detail page
sudo mount -t nfs <export-path> /mnt/shared
Mount at boot via /etc/fstab
<export-path> /mnt/shared nfs defaults,_netdev,nofail 0 0

Limits & specifications

Actions available on a file share:

ActionWhat it does
CreateProvision a new share on a share network.
Add access ruleAllow a client IP to mount, read-only or read-write.
ResizeGrow the share's capacity.
DeleteRemove the share and its data.

Best practices

  • Grant the narrowest access that works: read-only where writes are not needed.
  • Restrict access rules to specific instance IPs rather than broad ranges.
  • Use _netdev and nofail in /etc/fstab so a share that is briefly unreachable does not hang the boot.
  • Place shares on the same private network as the instances that mount them.
  • Do not use a file share as a database's data directory; use a block volume for that.

FAQ

How many instances can mount one share?
Many at once. That concurrency is the point of a file share; for single-instance disks use a block volume instead.
My mount command times out.
Check that an access rule grants the instance's IP, that the instance is on the share network, and that the NFS client package is installed.
Can I make a share bigger later?
Yes. Use Resize on the share to grow its capacity; the extra space is available to all clients.
Is a file share the same as object storage?
No. A file share is a POSIX file system you mount; object storage is accessed over the S3 API and is not mounted like a disk.

Learn more

Everything you can do here in the console is also available through the Patrii Cloud API for automation and scripting.

Was this article helpful?
Thank you for your feedback. Still stuck? Contact us