Ubuntu 24.04 LTS – NFS stale file handle errors on mounted share – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Applications fail file operations with stale NFS handle errors.

Environment & Reproduction

Often after server-side export remounts or inode changes.

mount | grep nfs
ls -la /mnt/nfs-share
dmesg | grep -i nfs | tail -n 60

Root Cause Analysis

Client inode references no longer match server export metadata.

Quick Triage

Identify impacted mounts and test remount behavior.

nfsstat -m
showmount -e 
findmnt -t nfs,nfs4

Step-by-Step Diagnosis

Correlate stale handle events with server export changes.

sudo journalctl -k -b -0 | grep -i nfs
stat /mnt/nfs-share
cat /etc/fstab | grep nfs

Solution – Primary Fix

Unmount and remount affected NFS shares cleanly.

sudo umount -f /mnt/nfs-share
sudo mount -a
ls -la /mnt/nfs-share

Solution – Alternative Approaches

Use automount with timeout to reduce long-lived stale handles.

sudo apt install -y autofs
sudo systemctl enable --now autofs

Verification & Acceptance Criteria

File operations succeed and stale handle messages stop.

touch /mnt/nfs-share/.nfs-test
rm -f /mnt/nfs-share/.nfs-test
dmesg | grep -i stale | tail -n 20

Rollback Plan

Reapply previous fstab mount options if new ones regress behavior.

sudo cp /etc/fstab.bak /etc/fstab
sudo mount -a

Prevention & Hardening

Coordinate export changes and client remount windows.

nfsstat -m
showmount -e 

Related Errors & Cross-Refs

Related to network interruptions and stale DNS records for NFS servers.

Related tutorial: View the step-by-step tutorial for Ubuntu 24.04 LTS.

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu NFS client/server troubleshooting guides.