Manage Cameras

Camera Requirements

The minimal camera requirements to connect IREX are:

  • Video streaming: RTP/RTSP over TCP or UDP
  • Video compression: H.264 Baseline Profile
  • Resolution: 720 x 480 (NTSC), see also resolution requirements for each video analytics module.
  • Valid RTSP URL with a static IP address

IREX is compatible with all ONVIF Profile S cameras.

Configure Cameras

Due to the compatibility and security requirements, IREX does not support a plug-and-play camera connection. A qualified network engineer is required to configure the camera and the router in order to enable video streaming from cameras to the IREX instance.

IREX supports multi-brand cameras. To prepare your cameras:

  1. Ensure the camera has a valid network configuration including IP address, network mask, gateway, and NTP client configuration. The correct time and timezone are essential for video archiving.
  2. Use the best security practices to protect your camera: install the latest firmware, generate a strong password, disable third-party cloud connection and unnecessary services.
  3. Ensure the camera mount position, height, angle of view, and resolution meet the requirements of the video analytics modules you plan to run for this camera.
  4. Set the video resolution to 1920x1080 or 1920x1440 on the primary stream and 740x480 (NTSC) on the secondary stream. The secondary stream (substream) is optional, it is required only for efficient video playback on Layouts or videowalls.
  5. Set the video codec to H.264 Baseline Profile (we are working on H.265 support!).
  6. Set the video codec mode:
    • VBR (variable bitrate) with a limit to 5 Mbps (recommended);
    • CBR (constant bitrate) to 5 Mbps if VBR with a bitrate limit is not available or the scene is very busy (e.g. airport entrance).
  7. Set the audio code to AAC. G.711ulaw and PCM are also supported. Audio streaming is optional.
  8. Note the RTSP URL for the primary and the secondary streams.
  9. Test the RTSP URLs in a media player such as VLC. Note the bitrate of the video stream.

How to Find Your Camera's RTSP URL?

RTSP stands for Real Time Streaming Protocol. RTSP allows you to pull a live video stream from your camera or NVR to the IREX Smart City Platform. International security standards such as ONVIF and PSIA rely on RTSP. Virtually all security cameras (except closed systems such as Verkada) are capable of transmitting RTSP.

The common format of the RTSP URL is: rtsp://[username:password@]ip_address[:rtsp_port]/server_URL[[?param1=val1[?param2=val2]โ€ฆ[?paramN=valN]]

Note that in most cases, the word server can be freely interchanged with the words IP camera as every IP camera has an RTSP server built in. Parameters in brackets are optional.)


Typically, the RTSP servers use DHCP to obtain an IP address automatically. The servers usually provide a utility for detecting the serverโ€™s IP address. This can be in the usual IPv4 format (xx.xx.xx.xx), or it can be a valid host address accepted by the standard function inet_addr.

For example, localhost is equivalent to This is usually the IP address of the sending (server) computer.

rtsp_port (Optional)

The port number on which the server is listening for RTSP commands. The port must be a number from 1 to 65535. Port 554 is the default for RTSP.

username / password (Optional)

For servers that use authentication, you will need to add your username and a password as part of the RTSP URL.


Each RTSP server has its own relative server URL, so you need to consult the serverโ€™s manual to obtain it.

paramN=valN (Optional)

Extra parameters in this context are server parameters that can be used to control compression, video size, etc. See the examples below for such parameters.

Example RTSP URLs

These examples are here to merely show the possible formatting for the RTSP URLs. They will not work for testing RTSP sources.

  • Axis rtsp://login:password@
  • Hikvision rtsp://login:password@
  • Dahua rtsp://login:password@

If you don't have the RTSP URL for your camara, try the following tips:

  1. Ask your network administrator or the camera installation company.
  2. Use ONVIF Device Manager to discover cameras and their RTSP URLs in your private network.
  3. Search the camera manual for the rtsp:// link.
  4. Check iSpy Camera Connection Database.

Configure your Network

Your network shall provide sufficient bandwidth to transmit the video stream from your cameras to the IREX instance (i.e. uplink), that can be hosted by IREX or the client. The typical bitrate for a Full HD camera in a public space is 5 Mbps.

Connecting a Camera to IREX Cloud

Option 1: NAT (the video streams will NOT be encrypted)

  1. Setup a Network Address Translation (NAT) on your router to connect a camera from your private network to
  2. In the RTSP URL, use the external IP address of your router and the NAT port instead of the internal IP address and port of the camera in your private network. Your router must have a static IP address.

Option 2: VPN (the video streams will be encrypted)

  1. Setup a Virtual Private Network (VPN) from your site or
  2. Use the original RTSP URLs of the cameras in your private network.

Option 3: IREX Edge Server (the video streams will be encrypted)

  1. Install the IREX Edge Server in your private network.
  2. Use the original RTSP URLs of the cameras in your private network.

Connecting a Camera to a Private Cloud

No special network configuration is required if the cameras and the IREX instance are in the same routable network. Use the original RTSP URLs of the cameras in your private network.

Add Camera

To connect a camera to IREX:

๏ปฟ๏ปฟ 1. On the User Menu > Settings > Cameras screen click a "+" > Create camera in the bottom-right corner of the screen.

Document image

2. In the Edge server section on the Adding channel screen that opens, select an edge server on which to execute video analytics.

3. In the Video stream section:

3.1 Select a TCP (recommended) or UDP data transfer protocol.

3.2 Paste the camera's RTSP link into the field of the same name (see the above instruction).๏ปฟ๏ปฟ

3.3 Click the Additional video stream to repeat the same actions for the additional stream if you wish to use a low-resolution substream for live video playback in a Layout.

Document image

4. In the Camera section:

Document image

4.1 Enter the name of the camera in the Name text box.

4.2 Enter camera tags in the Tags, or select those from the existing ones. The camera name and tags are shown on the camera card; they also facilitate by-name and by-tag search for a camera.

4.3 Select user groups to be given access to the camera in the Access for user groups.

๏ปฟ 5. In the Location group navigate to the camera location on the map and click; then rotate the โ€ข ๏ธto set the camera view angle.๏ปฟ

Use the address of the camera to quickly find it on the map

Document image

Click on a building passes its coordinates to the camera.

๏ปฟ 6. In the Video streaming recording settings group:๏ปฟ

Document image

6.1 Select output resolution and bitrate on the Select video stream characteristics list.

6.2 Switch on/off the Record video option to save the records to the cloud storage.

6.3 Switch on/off the Mute recording mode (self-explanatory).

6.4 Select an Archive depth. Video and events will be retained for this period of time. The default archived depth (retention period) is 30 days. 7. In the Additions group, switch on/off the PTZ Camera and Thermal imager options.

Document image

PTZ Camera Settings

๏ปฟSwitching on the PTZ camera setting requires the Port number and authorization credentials to be defined.๏ปฟ

Document image

Thermal Imager Settings

Switching on the Thermal Imager option requires IP, port number, and camera number on the DVR to be defined. Besides, switch on the thermal-related events to report.

Document image

Turn Camera off

When the camera is off, video is not recorded, video analytics modules are not running, live video is not transmitted to users.

To do so, use the Turn off command in the three-dot menu โ‹ฎ on the list of connected cameras.

Document image

Edit Camera

To change the parameters entered as described, click the Edit command in the three-dot menu โ‹ฎ on the camera list, and change.

Delete Camera

When you delete a camera, video recording and events are lost.

Deletion of a camera cannot be undone!

To delete a camera, click the Delete command in the three-dot menu โ‹ฎ on the camera list.








ยฉ 2021 IrexAI Inc