Skip to content

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.