Help & setup
Guides for getting Sentinel running, and how to reach us.
Email us
Write to [email protected]. Tell us your platform (Mac, Linux or iPhone), version and what happened.
Report a bug
Use Report a bug or email us. Include the Sentinel version, your platform and what you did just before. Remove passwords from anything you attach.
Read the FAQ
Pricing, privacy, cameras and remote access are covered in the FAQ.
Sentinel for Mac
- Needs macOS 13 or later on Apple Silicon or Intel. The media engine is included; nothing else to install.
- Download with your free account, open it, and move the app to your Applications folder. It's signed and notarized by Apple.
- For recording around the clock, keep the Mac powered and awake. A closed laptop lid sleeps the Mac unless it's on power with an external display.
Sentinel for Linux
- Runs on 64-bit Linux with systemd: x86-64 for Intel and AMD machines, ARM64 for boards like the Raspberry Pi 5.
- Unpack the download and run
sudo ./install.sh. Sentinel starts as a service and keeps running after reboots. - Open
http://your-server:8090from a browser on the same network and create the administrator account. - To upgrade, run the same steps with the new download. Your cameras, settings and recordings are kept. Full steps are in the install guide.
- Logs:
journalctl -u sentinel -f. By default recordings live in/var/lib/sentinel/recordings; you can pick another folder per server under Admin → Servers → Recording Servers.
iPhone & iPad
- Install Sentinel VMS from the App Store.
- In a browser, open your server's address (on a Mac, choose Open Web Dashboard from the Sentinel shield in the menu bar), go to Admin → Devices → iPhone Pairing and choose Pair iPhone.
- In the app, tap Scan Pairing QR. If you can't scan, tap Enter Server Info Manually and type the address and code shown next to the QR code.
- Pairing codes work once and expire after 5 minutes; just generate a new one if it times out.
Adding cameras
- Open Admin → Devices → Cameras and add a camera. Use the network scan to find ONVIF cameras automatically, then sign in with the camera's own username and password. Find streams asks the camera what it offers and picks the second stream for live view, detection and low-res recording.
- To change how a camera records (continuous, events only, or low-res 24/7 with full-res on events), open its recording settings. The server default is under Admin → Servers → Recording.
- If a camera isn't found, it may be on a different network segment. Add it by IP address instead, and check that ONVIF is turned on in the camera's settings.
- TP-Link Tapo: use the camera account you set under Advanced Settings → Camera Account in the Tapo app, not your TP-Link cloud login.
- You can always add a camera with its RTSP address, for example
rtsp://192.168.1.20:554/stream1.
Watching from away
Remote access is built in and needs no port forwarding: your server opens an encrypted tunnel, and your paired phone switches to it automatically when it isn't on your home network. Pair the phone once while it's on the same network as your server. If remote viewing stops working after a server restart, open the app once while on your home Wi-Fi so it picks up the new address. Sentinel Cloud gives your server a permanent address, so this step goes away.
AI features
Person, vehicle and animal detection runs on your own computer at no cost, and so do face recognition and plate reading once an administrator turns them on in Admin → People and Admin → Plates. Scene descriptions, AI search, the daily digest and Describe a rule use your own Anthropic (Claude) API key, added under Admin → Basics → System & Updates. You pay Anthropic directly, and you can set a daily limit on descriptions. Insights needs no key.
Troubleshooting
A camera shows "No signal" or a black tile
Check the camera is powered and reachable, and that its username and password are right. Sentinel needs an H.264 or H.265 stream; set the camera to one of those if it's streaming MJPEG.
Recording stops on budget cameras
Some low-cost cameras allow only two connections at once. Avoid viewing the camera in its own app at the same time, and leave the separate live-view stream off for that camera.
Playback is slow or a recording will not load
Open Admin → Servers → Recording Servers. An amber Recordings disk is slow badge means the disk holding that server's recordings is answering slowly, often a failing or overloaded drive. Move the Recordings folder to a healthier disk and back up what you need.
The iPhone app says it can't reach the server
Make sure the Sentinel computer is on and awake. On your home network, confirm the phone is on the same network as the server; away from home, remote access must be turned on.
Still stuck?
Email [email protected] with your platform, the Sentinel version and what happened. Step-by-step guides cover setup and everyday tasks.