An NVR with an iPhone app and no cloud
Aperture is a network video recorder you run on your own Linux machine, and its iPhone app connects straight to that machine. There is no Aperture account, no telemetry and no cloud storage for video. This page explains what the app does, how the phone reaches your server at home and away, what the push relay is and what it can see, and what stays local. Notifications are the one place an outside service is involved, and this page says exactly how.
What the app does
Section titled “What the app does”Aperture for iPhone is free on the App Store. It connects to an Aperture server you run. It does not work with other recorders or with cloud cameras. It has:
- live view of every camera, including H.265 cameras, with picture-in-picture;
- a timeline per camera, with detections marked where they happened;
- events: people, vehicles, animals and parcels that your server detected, filtered by type and camera;
- notifications with a snapshot, encrypted end to end, if you turn them on;
- sign-in with your Aperture account, or with a pairing code from the web app;
- automatic switching between your home address and your remote address;
- a Face ID lock and a home-screen widget;
- English and German.
What you need
Section titled “What you need”- An Aperture server, version 1.4 or newer, and an account on it. See Install.
- An iPhone with iOS 18 or newer.
- For use away from home: a public HTTPS address for your server, as described in HTTPS and remote access.
Install and pair
Section titled “Install and pair”- Install the app from the App Store and open it.
- Sign in. Either enter your server’s address and your Aperture account, or pair with a code: in Aperture in a browser, open Settings › Security, select Show pairing code under Pair a phone, and scan the code with the app. A pairing code works once and for five minutes.
- To find servers near you, the app needs Local Network access (Settings › Privacy & Security › Local Network on the phone), and the phone has to be on the same network as the server. If it does not find your server, type the address.
- To get notifications, turn them on in the app’s settings and choose the cameras and kinds of event you want.
To sign a phone out, use Settings in the app. If the phone is lost, sign it out from Aperture in a browser: the signed-in devices list under Settings › Security shows each phone by name. See Passwords, two-factor and passkeys.
How the phone reaches your server
Section titled “How the phone reaches your server”The app talks to your server directly, over your network or the internet. Nothing relays the video.
- At home, the app uses the server’s address on your network. The pairing code carries it.
- Away from home, the app uses your server’s public HTTPS address. You set that address up yourself, with a reverse proxy or a similar arrangement; see HTTPS and remote access. The app learns the remote address the next time it connects at home.
- The app switches between the two by itself.
If the app works at home and not away, the cause is almost always the missing public address.
Notifications without an Aperture account
Section titled “Notifications without an Aperture account”Apple delivers notifications to iPhones only from a server that holds Apple’s push credentials, and your Aperture server cannot reach Apple’s push service itself. Aperture therefore sends each notification to a push relay at push.aperturenvr.com, which the Aperture project operates on Cloudflare’s network, and the relay passes it on to Apple.
The path of one notification:
- Your server detects something and decides that a phone should hear about it: the phone’s account may see that camera, its app session still exists, the kind of event is one the phone asked for, and Aperture is armed.
- Your server encrypts the notification with a key that only that phone has (AES-256-GCM). It signs the request to the relay with a secret the relay issued to that phone, so a relay acts only on requests from a server the phone registered with.
- The relay forwards the encrypted message to Apple’s push service, which delivers it to the phone.
- The phone decrypts the message and loads the snapshot directly from your own server.
What the relay sees
Section titled “What the relay sees”| The relay receives | The relay cannot see |
|---|---|
| A random device identifier | Which camera, what was detected, or when |
| The encrypted message | The snapshot, or any picture |
| A random event identifier that Apple uses to merge duplicate alerts | Your accounts, e-mail addresses or passwords |
| Your server’s address |
For each registered phone the relay stores the random identifier, the secret it issued, Apple’s push address for the phone, the app’s identifier, whether Apple’s test or production system is used, and when the phone registered and last got a notification. The entry is removed when you turn notifications off or sign out of the app. The full description, including logs and retention, is in the privacy policy.
Which events produce a notification
Section titled “Which events produce a notification”- Each phone chooses its cameras and kinds: person, vehicle, animal and package are on by default; motion and audio can be added.
- A phone gets at most one notification per camera every 30 seconds.
- While Aperture is disarmed, no notifications are sent. Events are still recorded.
Turning it off or using another relay
Section titled “Turning it off or using another relay”The relay your server may send to is set by APERTURE_PUSH_RELAYS in /etc/aperture/aperture.env. The default is https://push.aperturenvr.com. Set it to none to turn phone push off. See Configuration.
What stays on your server
Section titled “What stays on your server”Video, snapshots, events, camera names and accounts go only to your own Aperture server. The app contains no analytics or advertising. Apart from your server, it contacts only the push relay (when you turn notifications on) and Apple’s own services. Recording, live view and playback do not use the relay.
For the other outbound connections your server can make, such as weather and model downloads, see What leaves your network.
Limits
Section titled “Limits”- The app is for iPhone. Android phones use Aperture in the browser; see On your phone.
- Notifications need your server to reach the relay over the internet. Without that, the app still shows live video and recordings, and the notifications stop.
- Remote viewing needs an HTTPS address of your own. There is no relay service for video.
- If notifications do not arrive, check that they are on for Aperture in the phone’s settings and in the app, that the cameras and kinds you want are selected, and that Aperture is armed.
- The app is version 1.0.
Related
Section titled “Related”On your phone · Notifications · What leaves your network · HTTPS and remote access