May 4, 2026

Mounting drama, unmounted pain

Show HN: nfsdiag - a NFS diagnostic application

This tiny server fixer has exhausted admins screaming, cheering, and reliving old nightmares

TLDR: nfsdiag is a small tool that checks why shared network folders are failing, from connection problems to weird permission issues. The community reaction was basically exhausted joy: admins praised it as a lifesaver and used the comments to relive their most miserable file-sharing nightmares.

A tiny new tool called nfsdiag just landed on Show HN, and the reaction was less “neat utility” and more group therapy for traumatized system admins. The app is basically a client-side detective for shared network drives: point it at a server, and it checks the usual chaos zones like connectivity, permissions, missing services, file locks, stale file errors, and whether the server is secretly treating users differently than expected. In plain English: it helps answer the cursed office question, “Why is the shared folder broken this time?”

The strongest reaction by far was pure relief. One commenter basically said this tool would have saved them at a past job, which is Hacker News code for “I have battle scars and receipts.” Another called it a “very powerful little helper,” giving the project the kind of approving nod that usually means, “finally, someone built the obvious thing nobody wants to build.” And then came the most emotionally charged hot take: debugging Kerberos login issues — the extra security layer often used in corporate setups — is, in one commenter’s words, a total nightmare. That line carried the thread’s biggest laugh, because everyone who’s touched old-school file sharing knows that pain is deeply, tragically real.

There wasn’t much outright fighting in the comments, but the drama came from the shared mood: NFS is the villain, this tool is the medic, and the commenters are survivors swapping war stories. The vibe was part applause, part flashback, and part “where was this when my weekend got ruined?”

Key Points

  • nfs-doctor is a client-side command-line diagnostic tool written in C for troubleshooting NFS servers.
  • The tool tests network reachability, rpcbind, NFS and mountd versions, exports, permissions, locking, root_squash behavior, stale file handles, and basic performance.
  • It supports automatic export mounting, UID/GID and supplemental group simulation, verbose output, and JSON reporting for automation.
  • The article warns that NFS results are highly environment-dependent and that failure to reproduce an issue such as ESTALE does not mean it cannot occur.
  • Build and usage instructions are provided for Debian, Ubuntu, Fedora, and RHEL-style systems, including package dependencies and command examples.

Hottest takes

"would have killed for a tool like this" — ktm5j
"Very powerful little helper" — lschueller
"What a pain in the ass that is to debug!" — kayson
Made with <3 by @siedrix and @shesho from CDMX. Powered by Forge&Hive.