Aperture

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.

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

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

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

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

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

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

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

SystemDebian 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 memoryFour cores and 4 GB of RAM record four cameras with motion detection. Object recognition wants more, or an NVIDIA card.
StorageAbout 43 GB a day for a camera at 4 Mbit/s. A surveillance-class disk or a NAS for the footage.
NetworkThe machine and the cameras on the same network, with fixed addresses. Ports 8971, 1883, 1984, 8554 and 8555 free.
CamerasAnything with an RTSP stream. ONVIF adds picture controls but isn’t needed.

Requirements and sizingInstall from source

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

  1. Open your Aperture address in Safari.
  2. Tap Share, then Add to Home Screen.
  3. Open it from the home screen and turn on notifications.

Android

  1. Open your Aperture address in Chrome.
  2. Open the menu, then Install app.
  3. Open it and turn on notifications.