cclohmar/NextNVR
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: storage setup guide — local, USB, NFS; NAS roadmap done

Browse source
This commit is contained in:
Claus Lohmar 2026-08-06 19:45:45 +01:00
parent 2f656aaa40
commit 8328f4049a
1 changed files with 43 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
README.md
View file

@ -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