⚖

Gold Knight Tech

Network Video Recorder · One program

OakNVR

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.

Linux · macOS · WindowsRaspberry Pi too
One filePages and AI model built in
Any browserThe app is a web page

1What it does

2Install - choose one of two ways

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.

Way 1 · One command in a terminal

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

Way 2 · Download the installer and double-click it

Instead of Way 1 - no terminal: click your system below, open the downloaded file, follow the steps.

🪟 Windows

Windows 10/11, x64. Windows may say "Windows protected your PC": click More info → Run anyway (the installer isn't signed yet). ⬇ OakNVR-Setup.exe

 macOS

macOS 11+, Apple silicon and Intel. If macOS won't open it: System Settings → Privacy & Security → Open Anyway (not signed yet). Install Homebrew first to get ffmpeg too. ⬇ OakNVR.pkg

🐧 Linux

Ubuntu 20.04+, Debian 10+, Raspberry Pi OS (64-bit). Open it with Software Install, or sudo apt install ./oaknvr_amd64.deb. ⬇ oaknvr_amd64.deb (PC) ⬇ oaknvr_arm64.deb (Raspberry Pi)

Which one?

Way 1: terminal commandWay 2: installer
HowPaste one line, press EnterDownload, double-click, Next → Finish
Good forOver SSH, servers, a Raspberry Pi without a screenAnyone at the computer
ffmpegLinux: a static build beside OakNVR · Windows: downloaded · macOS: from HomebrewLinux: the system's own (apt) · Windows: downloaded during setup · macOS: from Homebrew
RemoveThe commands in section 5Like any program (Settings → Apps; sudo apt remove nvr)
ResultThe 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.

Then

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.

3The app: Android, a browser, or on the Home Screen

Nothing comes from an app store. OakNVR serves two pages:

Android app

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).

⬇ OakNVR.apk (Android)

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.

As an app on a phone, from the page

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.

4Notifications on phones (Web Push)

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:

A. Your own https

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.

B. Through goldknighttech.ca

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.

Turning them on

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.

5Update and remove

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.