From 8328f4049a5a04ce210f705bf3b170ad38660a3c Mon Sep 17 00:00:00 2001
From: cclohmar <claus.lohmar@lohmar.co.uk>
Date: Thu, 6 Aug 2026 19:45:45 +0100
Subject: [PATCH] =?UTF-8?q?docs:=20storage=20setup=20guide=20=E2=80=94=20l?=
 =?UTF-8?q?ocal,=20USB,=20NFS;=20NAS=20roadmap=20done?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d69ea8c..5cb3843 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ STORAGE_PATH=/mnt/recordings ./deploy_nvr.sh
 | Feature | Detail |
 |---|---|
 | 📹 **Recording** | Up to 8 cameras simultaneously, 5-minute MP4 clips, zero transcoding |
-| 💾 **Storage** | Flat per-camera directories, 7-day retention, auto-cleanup |
+| 💾 **Storage** | Set any path — local disk, USB drive, or network mount |
 | 🖥️ **Live Wall** | 4×2 grid with auto-refreshing snapshots. Click for full live stream |
 | 🔍 **Playback** | Browse recordings by camera and date with snapshot thumbnails |
 | ⚙️ **Setup Wizard** | ONVIF network scan + camera naming. Add cameras manually too. |
@@ -60,6 +60,47 @@ STORAGE_PATH=/mnt/recordings ./deploy_nvr.sh
 
 ---
 
+## Where to Store Recordings
+
+NextNVR saves video clips and snapshots to a directory you choose. By default this is `~/nvr_data`. You can change it in **Settings → Storage path** or by editing `config.json`.
+
+### Local disk
+```bash
+# Use the system drive (default)
+Storage path: /home/pi/nvr_data
+
+# Use a second internal drive
+sudo mkdir /data/nvr
+sudo chown $USER:$USER /data/nvr
+# Then set: /data/nvr
+```
+
+### USB drive
+```bash
+# Plug in the drive, find it:
+lsblk
+# Mount it:
+sudo mkdir /mnt/usb-drive
+sudo mount /dev/sdb1 /mnt/usb-drive
+# Make it permanent (/etc/fstab):
+# /dev/sdb1 /mnt/usb-drive ext4 defaults 0 2
+# Then set: /mnt/usb-drive/nvr
+```
+
+### Network share (NAS / NFS)
+```bash
+# Install NFS client:
+sudo apt install nfs-common
+# Mount the share:
+sudo mkdir /mnt/nas
+sudo mount 192.168.1.100:/volume1/nvr /mnt/nas
+# Make it permanent (/etc/fstab):
+# 192.168.1.100:/volume1/nvr /mnt/nas nfs defaults 0 0
+# Then set: /mnt/nas
+```
+
+---
+
 ## Authentication
 
 NextNVR runs two HTTP servers:
@@ -105,8 +146,8 @@ Stops the service, removes `/opt/nextnvr/`, cleans up systemd. Recordings on dis
 | Playback browser with date presets | ✅ Done |
 | 7-day retention with auto-cleanup | ✅ Done |
 | Two-port authentication (master + viewer) | ✅ Done |
+| **NAS / Network storage** (point recordings to any mounted path — NFS, SMB, USB) | ✅ Done |
 | **Camera-triggered recording** (ONVIF motion/person detection events via API) | 🔜 Planned |
-| **NAS/SMB storage support** (record to network share) | 🔜 Planned |
 | **Multi-platform builds** (Raspberry Pi, ARM SBCs) | 🔜 Planned |
 
 ### Not Planned