From e03905b26d9b68d08c1b0e3dce2d6d31db520930 Mon Sep 17 00:00:00 2001
From: marc <marc@shortcake.local>
Date: Fri, 19 Jun 2026 23:55:50 +0200
Subject: [PATCH] README: add Linux client mount guide for SMB and NFS

Covers one-time and permanent (fstab) mounts for both protocols,
credentials file for SMB, _netdev flag, multi-network NFS clients,
and useful commands (showmount, umount, mount -a).
Also remove stale "quotas" from the project description line.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1b621d2..13259e8 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # MicroNAS
 
-Lightweight web GUI to manage SMB shares, NFS exports, quotas, and users on a single home server (Proxmox LXC/VM). Runs directly on the host as a systemd service.
+Lightweight web GUI to manage SMB shares, NFS exports, and users on a single home server (Proxmox LXC/VM). Runs directly on the host as a systemd service.
 
 ## Proxmox LXC setup
 
@@ -87,3 +87,66 @@ Note: SMB/NFS/user management calls require root and the relevant daemons — ru
 ## Auth
 
 All routes require a login session. Go to `http://<lxc-ip>:5000` — you will be redirected to the login page automatically. Credentials come from `MICRONAS_USER` / `MICRONAS_PASS` in `/etc/micronas.env`. If `MICRONAS_PASS` is not set the app starts unprotected and logs a warning — do not do this in production.
+
+---
+
+## Mounting shares on a Linux client
+
+Replace `<nas-ip>` with your LXC's IP address throughout.
+
+### SMB (Samba)
+
+```bash
+# Install client tools
+apt install cifs-utils
+
+# One-time mount
+mount -t cifs //<nas-ip>/sharename /mnt/nas -o username=youruser,password=yourpass
+
+# Permanent — add to /etc/fstab:
+//<nas-ip>/sharename  /mnt/nas  cifs  username=youruser,password=yourpass,_netdev  0  0
+```
+
+For better security, store credentials in a file instead of putting them in fstab:
+
+```bash
+# Create /etc/nas-credentials (root-only):
+cat > /etc/nas-credentials <<EOF
+username=youruser
+password=yourpass
+EOF
+chmod 600 /etc/nas-credentials
+
+# Then in /etc/fstab:
+//<nas-ip>/sharename  /mnt/nas  cifs  credentials=/etc/nas-credentials,_netdev  0  0
+```
+
+### NFS
+
+```bash
+# Install client tools
+apt install nfs-common
+
+# One-time mount
+mount -t nfs <nas-ip>:/srv/data /mnt/nas
+
+# Permanent — add to /etc/fstab:
+<nas-ip>:/srv/data  /mnt/nas  nfs  defaults,_netdev  0  0
+```
+
+`_netdev` tells the system to wait for the network before mounting — important for both SMB and NFS so the mount doesn't fail on boot.
+
+**Multiple networks (e.g. LAN + Tailscale):** enter both subnets space-separated in the Clients field when creating the export, e.g. `192.168.1.0/24 100.64.0.0/10`. Both get the same ro/rw setting.
+
+### Useful commands
+
+```bash
+# List available NFS exports from the server
+showmount -e <nas-ip>
+
+# Unmount
+umount /mnt/nas
+
+# Mount all fstab entries (after editing fstab)
+mount -a
+```