opensensor /lightNVR

The fully OSS lightweight network video recorder system witten in C (and now rust) with modern js frontend

★ 299⑂ 72👁 5⑃ 679● 214▤ 108
CGPL-3.0Created 2025-03-07lightnvr.com
Download: Release v0.48.2Release-0.48.2 ↓0.48.22026-11-13
+0
Daily
299
stars
72
forks
5
watchers
679
prs
214
issues
108
releases

README

LightNVR









A self-hosted network video recorder that runs on anything from a 256 MB embedded
board to a server. LightNVR records your IP cameras, streams them live to the browser
over WebRTC or HLS, and finds what matters with detection zones, ONVIF events and licence
plate search — all locally, with no cloud account.

!Live view

 Free to use does not mean free to build. About $10,000 of the maintainer's own money
 has gone into LightNVR over roughly two years. If it saves you money or supports your
 customers, please help through the $10K Sustainability Drive or
 sponsor on GitHub.

 What it does

Record
- Continuous, scheduled, motion- and detection-triggered recording to standard MP4, with a
  pre-event buffer so clips include what led up to them
- Retention policies, recording protection and tags, and disk-space management
- Optional archival to S3, NFS or SAN storage (storage & archive)

Watch
- Live grid over WebRTC (sub-second) or HLS, with detection overlays — proxied and
  authenticated through LightNVR, built on go2rtc
- Recordings browser, a timeline, and an Investigation workspace that reviews up to 16
  cameras against one shared clock without hiding gaps in footage
- Clip and multi-camera export

Detect
- Polygon detection zones with per-zone object classes and confidence thresholds
  (zones)
- External detection through light-object-detect
  (ONNX/TFLite) or DOODS2, or embedded
  SOD for small devices (detection engines)
- ONVIF discovery and camera-side motion events (ONVIF)
- Licence plate reads with plate search

Run it securely
- Database-backed users with roles, TOTP multi-factor authentication and API keys
- A forced password change on first login; go2rtc's API kept on loopback
- Operational health: OS, container, filesystem and hardware sampling, incidents, and
  Prometheus metrics (system health)
- Non-root container image with all capabilities dropped

Integrate
- REST API with an in-app API reference (API)
- MQTT events and Home Assistant discovery (MQTT,
  Home Assistant)

The web UI ships in 19 languages, with light and dark modes and eight colour themes.

| !Detection zone editor | !Recordings |
|:---:|:---:|
| Detection zone editor | Recordings |
| !Stream configuration | !System |
| Per-stream detection settings | System health |

 Quick start

 Docker Compose

bash
mkdir lightnvr && cd lightnvr
curl -LO https://raw.githubusercontent.com/opensensor/lightNVR/main/docker-compose.yml
docker compose up -d


Open http://:8080. Images are published to ghcr.io/opensensor/lightnvr for
linux/amd64, linux/arm64 and linux/arm/v7 on every release. Volumes, ports,
environment variables and upgrades are covered in the Docker guide.

 Other ways to install

| | |
|---|---|
| Home Assistant | Add opensensor/lightnvr-hassio-addons under Settings → Add-ons → Add-on Store → ⋮ → Repositories, then install LightNVR. See Home Assistant. |
| Debian / Ubuntu | .deb packages for amd64, arm64 and armhf are attached to each release. |

Top issues

Discussions

Latest release

Release v0.48.2 v0.48.2 2026-11-13
🤖 AI-Generated Changelog

 Changed
- Regenerated Rust bindings (lightnvr-rs) from updated C source

---

🔗 Full Changelog: https://github.com/opensensor/lightNVR/compare/0.48.1...v0.48.2

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON