Records your IP cameras (H.264 or H.265, with their sound) to disk exactly as they send them - nothing is re-encoded, so one small computer records many cameras. Watch live and play back in any browser or as an app on a phone, find people and vehicles, get notified, and keep recordings for as long as your disks allow.
Both ways end the same: OakNVR installed, with ffmpeg, starting with the computer. Use one of them, not both. To update later, do the same again - your cameras, settings and recordings stay.
The command downloads the program for your system, checks it, puts ffmpeg beside it and sets it up to start with the computer. Nothing to download first.
Linux and macOS (Terminal):
curl -fsSL https://goldknighttech.ca/downloads/nvr/install.sh | sudo sh
Windows (right-click Start → Terminal (Admin)):
irm https://goldknighttech.ca/downloads/nvr/install.ps1 | iex
Instead of Way 1 - no terminal: click your system below, open the downloaded file, follow the steps.
sudo apt install ./oaknvr_amd64.deb.
⬇ oaknvr_amd64.deb (PC)
⬇ oaknvr_arm64.deb (Raspberry Pi)
| Way 1: terminal command | Way 2: installer | |
|---|---|---|
| How | Paste one line, press Enter | Download, double-click, Next → Finish |
| Good for | Over SSH, servers, a Raspberry Pi without a screen | Anyone at the computer |
| ffmpeg | Linux: a static build beside OakNVR · Windows: downloaded · macOS: from Homebrew | Linux: the system's own (apt) · Windows: downloaded during setup · macOS: from Homebrew |
| Remove | The commands in section 5 | Like any program (Settings → Apps; sudo apt remove nvr) |
| Result | The same NVR, starting with the computer, at http://<the computer's IP>:8810 | |
Where it goes. Linux: /opt/nvr, recordings in /var/lib/nvr (a system user nvr, systemd: systemctl status nvr). macOS: /usr/local/nvr, recordings in /usr/local/var/nvr - keep the Mac from sleeping (System Settings → Energy) so it keeps recording. Windows: C:\Program Files\NVR, recordings in C:\ProgramData\NVR, started by Task Scheduler (NVR), ports 8810 and 8554 opened in the firewall.
Just the program, to run it your own way: Linux x86-64 · Linux arm64 · macOS · Windows · SHA256SUMS · version …. The Windows and Raspberry Pi builds are new: tell us how they go.
Open http://<the computer's IP>:8810/admin from any browser on the same network. The first visit asks you to choose the admin's name and password - do it right away. Then Settings → Cameras → + Add camera: choose the brand and type the camera's IP, user and password, or Find cameras on the network.
About ffmpeg. ffmpeg is a separate program (GPL) OakNVR calls when it needs a picture: motion from the picture, event snapshots and people/vehicle detection, H.264 for browsers that can't play H.265, clips and time-lapses. Either way of installing gets it for you (see the table above: Linux's own package or a static build from johnvansickle.com, Windows from gyan.dev, macOS from Homebrew). Without it OakNVR still records, shows live and plays back.
Nothing comes from an app store. OakNVR serves two pages:
/client - for everyone: live, playback, alerts, several NVRs in one app (home, office, cottage), each with its own login./admin - for the admin: cameras, recording, storage, accounts, status.The OakNVR app for Android phones and tablets (Android 8 or later): live, playback and several NVRs, as the page - and its alerts arrive straight from your NVR, with the picture, even with the app closed: no https needed, no Google services (it works where they are blocked).
Open the download on the phone; if Android asks, allow installing apps from your browser. The first time, the app asks for your NVR's address (as https://<code>.goldknighttech.ca/nvr/client, or http://192.168.1.20:8810/client at home) - then add your NVR and log in as on the page. Alerts on the app need OakNVR from November 2026 or later.
iPhone / iPad: open /client in Safari → Share → Add to Home Screen. Open it from the Home Screen icon from then on: it runs full screen, like an app.
Android (without the app above): open it in Chrome → ⋮ menu → Add to Home screen (or Install app).
Computer: Chrome or Edge show an Install icon in the address bar; or just keep a bookmark.
Alerts arrive as real notifications, with the picture, even when the app is closed - no account with us or anyone else. Browsers allow this only for a page opened over https, so OakNVR needs an https address. Two ways:
With a domain of your own pointing to your home (and port 443 forwarded to OakNVR's computer), put Caddy in front of it - it gets and renews the certificate by itself. Its whole configuration:
nvr.example.com {
reverse_proxy 127.0.0.1:8810
}
Or give OakNVR a certificate you already have: nvr --tls-cert cert.pem --tls-key key.pem.
We give your NVR its own address, https://<code>.goldknighttech.ca/nvr/ (your Oak, if you have one, at /oak/), through an encrypted tunnel (WireGuard) from your home - no port forwarding, no domain, works from anywhere, and notifications work at once. Only you and the people you give accounts to can log in. Ask us for remote access with the message form.
The Android app needs none of the above: its own connection to your NVR brings the alerts, on the local address too. Switch them on the same way:
In the app: Me → Alerts on this device → switch on for OakNVR, then Cameras to choose which ones. On an iPhone: iOS 16.4 or later, and the app must be opened from its Home Screen icon (not a Safari tab) - Apple allows notifications only there.
No https? Use the free ntfy app instead: subscribe to a topic of your own there, and put https://ntfy.sh/<your-topic> in OakNVR's Settings → Alerts. It works on the local address too.
Update: the same way you installed - run the command again, or download and open the new installer.
Remove - installed with Way 2: like any other program (Windows: Settings → Apps → OakNVR; Linux: sudo apt remove nvr, or purge to delete the recordings too). Installed with Way 1, or a Mac (the recordings stay in the data folder until you delete it):
# Linux sudo systemctl disable --now nvr && sudo rm -rf /opt/nvr /etc/systemd/system/nvr.service # macOS sudo launchctl bootout system /Library/LaunchDaemons/ca.goldknighttech.nvr.plist; sudo rm -rf /usr/local/nvr /Library/LaunchDaemons/ca.goldknighttech.nvr.plist # Windows (PowerShell as administrator) Unregister-ScheduledTask NVR -Confirm:$false; Stop-Process -Name nvr -Force; Remove-Item -Recurse "$env:ProgramFiles\NVR"
Home automation too? Oak runs lights, locks, alarm panels and more alongside OakNVR - same computer, same app on the phone.