Troubleshooting
When something isn't working, this page covers the most common issues and where to look. The Logs are the best place to see what the server is actually doing.
A camera won't connect
If a camera shows offline or won't load:
- Check the camera's sources. The Sources tab shows each stream's live status, detected codecs, and URL.
- Make sure the stream URL and credentials are correct. Testing the RTSP URL in a player like VLC confirms the camera itself is reachable.
- Confirm the camera is on the same network as the server, or otherwise reachable from it.
- For brand or discovery-based cameras, check the relevant protocol or plugin.
Live view is black or won't play
- Check the source's codec in the Sources tab; very unusual codecs may need transcoding.
- Try a different streaming mode in the camera's interface settings.
- Enable hot mode and preload on the source for faster, more reliable opening.
Detection isn't firing
- Make sure a motion engine and, for objects, an AI backend are assigned to the camera. See Set up sensors.
- Lower the confidence or motion sensitivity in Settings → Detection if events are missed.
- Check your zones aren't excluding the area.
- Remember the cascade: object, face, and plate detection only run after motion or another trigger. See Detection.
No notifications
- Check the notification settings on the device: the master switch, quiet hours, and whether the device is registered.
- Check the camera's notification settings: which objects, sounds, and sensors it alerts on.
- For push to a phone, confirm camera.ui Cloud is set up; push needs the subscription.
Recording isn't working
- Recording needs an active subscription. See Recording.
- Confirm the camera's recording mode is set, either continuous or event.
- Check storage: a full disk with Strict retention pauses recording until you free space.
Can't reach the server remotely
- In Settings → Remote, confirm cloud access is enabled and the server is registered, with the tunnel connected.
- For a direct connection, use Test connection to check the address is reachable.
- The mobile apps need camera.ui Cloud to connect from outside your network.
Getting more detail
- Open the Logs and filter or search for the issue. You can download the log to share when asking for help.
- For deeper inspection, the Terminal gives a shell on the server.
Still stuck?
Ask the community on Discord or Reddit, or open an issue on GitHub. Include your logs and the steps that led to the problem.