Skip to content

Troubleshooting Cameras

When cameras fail to connect or stream properly in RUSEON Core, follow these troubleshooting steps.

Camera Offline / Reconnection

If a camera stream drops, RUSEON Core enters a reconnect loop. It will attempt to re-establish the connection every 5 seconds.

  1. Check the logs for RTSP connection timeouts or "connection refused" errors.
  2. Verify that the url is correct, including authentication credentials.
  3. Ensure the camera is powered on and reachable from the server running RUSEON Core.

Transport Issues (TCP vs UDP)

By default, RUSEON Core uses tcp for the RTSP transport.

  • Symptoms of UDP issues: Smearing, macroblocking, or dropped frames (especially over Wi-Fi or cellular networks).
  • Fix: Ensure transport is set to tcp. If the camera strictly requires UDP, change it to udp and ensure your network does not aggressively drop UDP packets.

Authentication Failures

If the camera logs show 401 Unauthorized:

  • Verify the username and password in the RTSP URL: rtsp://USER:PASS@IP/stream.
  • Some cameras lock out IPs after multiple failed attempts. You may need to reboot the camera or clear its blacklist.

Stream Token Errors

If clients cannot view the stream via WebRTC or HLS, check if token_auth is set to true for the camera. If it is, the client must provide a valid stream token when requesting the media.

Released under the MIT License.