Install Aperture
On a Linux machine that stays on: a mini PC, an old laptop or a virtual machine. Run one command, answer a few questions, and the wizard does the rest. Free for noncommercial use.
$ curl -fsSL https://aperturenvr.com/install | sudo sh
The script downloads aperture-setup for this machine, checks its checksum and starts it. It’s short: read it first at aperturenvr.com/install.
What the wizard does
It changes nothing until you’ve seen the whole plan. Every screen says what it found and what it will do about it.
Checks the machine
The system, memory and disk space, the ports Aperture needs, anything in the way such as
avahi-daemon, and an NVIDIA card if there is one. A problem comes with the fix, and one key applies it.Asks how you’ll open it
This machine’s address, your own domain with HTTPS through Caddy, a reverse proxy you already run (it prints the exact settings for yours), or only your Tailscale network.
Asks where footage goes
Any disk in the machine, with how many days it holds at a typical bitrate. Network shares come later, in the app.
Offers the options that matter
Object recognition on the processor or an NVIDIA card. If the card has no driver yet, one checkbox installs the right one for it, and the wizard says it needs a restart at the end.
Shows the plan, then installs
Every command and the full text of every file, before anything happens. Then the install with progress, the downloads checked against their checksums.
Tests it like a browser would
Opens the address, checks the certificate where there is one, and opens the live-video connection. If something is off it says what to change.
Creates your account
The first administrator, then the address and a QR code to open it on your phone.
What it needs
Recording copies the camera’s stream instead of re-encoding it, so a modest machine handles several cameras.
| System | Debian or Ubuntu on 64-bit x86, with systemd. Other systemd distributions can build from source. A Raspberry Pi or another ARM board won’t work. |
|---|---|
| Processor and memory | Four cores and 4 GB of RAM record four cameras with motion detection. Object recognition wants more, or an NVIDIA card. |
| Storage | About 43 GB a day for a camera at 4 Mbit/s. A surveillance-class disk or a NAS for the footage. |
| Network | The machine and the cameras on the same network, with fixed addresses. Ports 8971, 1883, 1984, 8554 and 8555 free. |
| Cameras | Anything with an RTSP stream. ONVIF adds picture controls but isn’t needed. |
Afterwards
The same program looks after the install.
aperture-setup update # the newest release, one restart, rolled back if it isn’t healthy aperture-setup doctor # tests the address like a browser, and says what to change aperture-setup status # services, cameras recording, disk aperture-setup plan # prints what an install would do, changes nothing nvrctl # the admin console in the terminal, over SSH too
On your phone
There’s no app to download. Open your Aperture address and add it to the home screen: it opens full screen and can send push notifications with a thumbnail.
Phones allow that only over HTTPS, so choose a domain, your own proxy or Tailscale in the wizard.
iPhone and iPad
- Open your Aperture address in Safari.
- Tap Share, then Add to Home Screen.
- Open it from the home screen and turn on notifications.
Android
- Open your Aperture address in Chrome.
- Open the menu, then Install app.
- Open it and turn on notifications.