Skip to content

Adding Your First Camera & Vendor RTSP Guide ​

This guide walks you through connecting your first IP camera or RTSP video encoder to RUSEON Core, configuring stream properties, and enabling automated archiving.


1. Vendor RTSP URL Reference ​

Before adding a camera, verify its RTSP URL format. Replace user, pass, and 192.168.1.100 with your camera's actual credentials and IP address:

VendorMain Stream (High-Res Archive)Sub Stream (Low-Res Multi-View)
Hikvision / HiWatchrtsp://user:pass@192.168.1.100:554/Streaming/Channels/101rtsp://user:pass@192.168.1.100:554/Streaming/Channels/102
Dahua / Imourtsp://user:pass@192.168.1.100:554/cam/realmonitor?channel=1&subtype=0rtsp://user:pass@192.168.1.100:554/cam/realmonitor?channel=1&subtype=1
Reolinkrtsp://user:pass@192.168.1.100:554/h264Preview_01_mainrtsp://user:pass@192.168.1.100:554/h264Preview_01_sub
Axis Communicationsrtsp://user:pass@192.168.1.100:554/axis-media/media.amprtsp://user:pass@192.168.1.100:554/axis-media/media.amp?videokeyframeinterval=30
Uniview (UNV)rtsp://user:pass@192.168.1.100:554/unicast/c1/s0/livertsp://user:pass@192.168.1.100:554/unicast/c1/s1/live
Generic ONVIF Profile Srtsp://user:pass@192.168.1.100:554/onvif1rtsp://user:pass@192.168.1.100:554/onvif2

TIP

Special Characters in Credentials: If your password contains characters like @, :, or #, URL-encode them. For example, @ becomes %40 (rtsp://admin:pass%40123@192.168.1.100:554/live).


2. Adding a Camera via the Web Dashboard ​

  1. Log into your RUSEON Web Dashboard at http://localhost:8080.
  2. Click Add Camera in the top navigation bar.
  3. Configure the camera parameters:
    • Camera ID: Unique alphanumeric identifier (e.g. cam-01).
    • RTSP URL: Full URL from the vendor table above.
    • Transport Protocol: Select TCP (prevents UDP packet drop artifacts).
    • Record: Check to store video in the fMP4 archive.
    • Retention Days: (Optional) Override system archive retention in days.
  4. Click Save & Connect.

3. Adding a Camera via CLI ​

You can quickly add cameras directly using ruseon-cli:

bash
ruseon-cli cameras add \
  --id "cam-entrance" \
  --url "rtsp://admin:pass@192.168.1.100:554/live" \
  --record

Released under the MIT License.