Camera Setup Guide


This Guide explains the various ways you can connect your camera to Lumeo.

Gateway TypeSupported CamerasConfiguration
Lumeo Cloud GatewayAny IP Camera with provides a RTSP or HTTP stream, and is accessible via the public internet.
You may need to use port forwarding if your cameras are behind a router or firewall.
See Stream Setup section below.
Local GatewayONVIF-enabled IP Camera
Any IP Camera that provides a RTSP or HTTP stream.
See ONVIF Setup section if your camera supports ONVIF.

Alternatively, use Stream Setup section if your Camera does not have ONVIF enabled.
Local GatewayUSB CameraSee Camera page.


Discover Cameras

To Link a new IP Camera with your Application, start by discovering it on the Gateway detail page. Lumeo will automatically discover Onvif IP cameras on the same subnet as your Gateway. Click the Add Camera button to start and Onvif discovery.

This will start an Onvif discovery for cameras. Once discovered, you can link the camera by providing camera credentials. Click the link button.

This will open an additional window to complete the connection with the camera. Here you will need to put in the Onvif user and password.

Manually Add Cameras

If the Camera doesn't show up in Discovery, you can also try to add it manually by specifying it's IP address as long as it is reachable via the chosen Gateway.

Click on Add Camera and then Manually add cameras

From this window you can select the gateway and then input the ip address, Camera name and Onvif user credentials for the camera.

If this does not work you might not have Onvif setup on your camera. There are some instructions below to setup Onvif on a couple of popular camera models.

Enable ONVIF on camera

Refer to your Camera's instructions on how to enable ONVIF. Here are some steps for popular camera brands:


Step 1: Log into the web interface of the camera

  • Type in the IP address of the camera into a web browser (like Chrome or Internet Explorer)

Step 2: Go to System Options > Security > ONVIF

Step 3: Click the "Add..." button

Step 4: Create a user with administrator privileges

Step 5: Save the configuration


Step 1: Log into the web interface of the camera

  • Type in the IP address of the camera into a web browser (like Chrome or Internet Explorer)

Step 2: Go to Configuration > Network > Advanced Settings > Integration Protocol

Step 3: Check on the 'Enable ONVIF' or 'Enable Open Network Video Interface' box

Step 4: Check on the 'Enable Hikvision CGI' box

Step 5: Set 'Hikvision CGI Authentication' to 'digest/basic'

Step 6: Click on the 'add' button and create a ONVIF profile

  • You can use whatever user name and password you want
  • For the level:
    • Media Users: have access to get the real-time streaming, get a list of device supported functions, and read configurations of device.
    • Operators: have access to all settings except:
      • Causing changes to the system configuration, such as setting network default gateway
      • Causing unrecoverable changes to the system, such as setting system factory default and upgrading system
      • Reading confidential system configuration information, such as getting system log
    • Administrators: have unrestricted access to all settings.

Step 7: Click on the 'Apply' button on the bottom of the screen once you are done.

Stream Setup

If your camera is not ONVIF enabled, or you are trying to access the Camera from a Gateway outside the firewall (such as from a Lumeo Cloud Gateway), you can add it as a Stream. To do this you will need to find the rtsp url for your particular camera model. Look for it in the camera manual or find your camera model below:

Once you find a URL for your camera go to Streams.

Then Click the Add Input stream button in the top right.


Use a public IP Address in the Stream URI when using Lumeo Cloud Gateways

If using the Lumeo Cloud gateway, you will need to ensure that the Stream URL you configure in Lumeo uses the public IP address with port forwarding. See next section for how to set it up.

Here you will put in the URL for your camera an optional name and then save streams.

Forward RTSP through firewall

This is something that is help when trying to connect a camera at your site to a cloud gateway. To do this you are going to need to setup port forwarding on your router. Here are some basic instructions to complete this. Please check with the manual for your specific router. After you have completed the steps below you can go to to find your public ip for your router to use in the RTSP stream section above.

  1. On your web browser address bar, type your router's IP Address/Default Gateway or use your router's Mobile app.
  2. Log in with your router's credentials (username and password) to view your router's firmware settings.
  3. Navigate to the port forwarding section of your router.
  4. Click on Port Forwarding.
  5. Enter the IP address of your camera in your router in the correct box.
  6. Put the destination RTSP TCP and UDP ports of the Camera in the boxes in your router. The default RTSP port number is 554.
  7. Pick a unused public port as the source port (the first one can be 554, but if you are mapping multiple cameras, each will need a different public port). And then click the apply button.
  8. And you're done. Restart your router to let the changes take effect.
  9. Once your changes take effect, now you can use your public IP address and public port to setup a Stream. The final RTSP URL that you configure in Lumeo Console will look like following:


ex. rtsp://admin:[email protected]:8554/onvif1

Common Misconfigurations

  • Configuring your internal network IP in Lumeo Console when you are using Lumeo Cloud Gateways
    • IP Addresses that start with 192.168.x.y or 10.0.x.y or 172.16.x.y are internal IP addresses, not your public IP address. They can only be used when the Lumeo Gateway is deployed within your network.
  • Missing credentials
    • If your camera is using RTSP credentials (which may be different from an email address used to setup web access for the camera), you will need to ensure they are present in the RTSP URL as rtsp://username:password@....
  • Port Forwarding is not setup or not working correctly
    • Often times, using your internal IP address and playing the RTSP stream with VLC from within your network will work just fine. However, if the port forwarding is not setup correctly, Lumeo Cloud gateways cannot access the stream from outside your network.
    • To verify, create your RTSP URL with the public IP address and forwarded port, and play that using VLC.