Agent DVR - Troubleshooting

Accessing logs

Agent DVR makes it easy to keep an eye on what's happening under the hood with formatted live logs. You can find these logs right on the local server at /logs.html. For a default setup, that's http://localhost:8090/logs.html. Perfect for real-time insights!

From version onwards, Agent DVR also stores the five most recent raw logs in .json format in your Media folder. On Windows, this is typically located at C:\Program Files\Agent\Media. These detailed logs are great for debugging and understanding the inner workings of Agent.

Need to access logs remotely? No problem! You can download these raw logs right from the server menu in the web portal. And if you have questions or need a helping hand, our Community boards are just a click away. Join the conversation and get the support you need!

Installation Issues

Running into issues with the Windows installer for Agent? If it fails to complete, or if Agent doesn't start, or you need additional functionalities not available in the Windows service mode (like certain GPU drivers and desktop monitoring), here's a workaround using the command prompt:

  • First, stop the Agent service if it's running. Go to Start, type "services.msc", and hit enter. Find "Agent" in the list, right-click it and select "Stop". To prevent it from auto-starting, right-click on "Agent", go to Properties, set the startup type to "Disabled", and apply the changes.
  • Next, open a console window. Click Start, type "cmd", right-click "Command Prompt" and select "Run as administrator".
  • Then, navigate to the Agent directory, usually "cd C:\Program Files\Agent".
  • Finally, run Agent DVR as a console application by typing "Agent.exe" and hitting enter.

Agent will inform you of any startup issues and the local port it's using. You can exit Agent anytime by pressing enter. Running Agent in the console enables more GPU device usage and desktop recording capabilities.

Facing an error like 'The type initializer for 'Emgu.CV.Cuda.CudaInvoke' threw an exception.' on Windows? You might need to install the Windows Media Feature Pack for your OS.

If an antivirus app or firewall is blocking Agent's access to local ports, consider adding Agent.exe to the safe list or opening the necessary port in your firewall.

Using Windows N? You'll need the media feature pack for Windows N.

On OSX, Linux, or Raspberry Pi, missing libraries can cause start-up failures (like a missing ''). Use commands like 'ldd' or 'objdump -r --dylibs-used' to identify and install missing dependencies. If you encounter such issues, contact us so we can update our documentation and assist you better!

Glitchy Video

Experiencing glitchy video? Let's smooth things out! Agent DVR defaults to using UDP for quick, real-time video, but switching to TCP could solve any corruption issues at the cost of slight buffering. Here are some other tips and tricks you can try:

To modify these settings, edit the video source from the General tab of the camera editor and choose FFmpeg or Advanced in the top right menu
  • Switch to TCP in the FFmpeg RTSP mode settings for a more stable connection.
  • Try CPU decoding on the Advanced tab if GPU decoding isn't cutting it.
  • Consider using VLC as the Decoder on the Advanced tab if it's available.

Reolink Cameras, in particular, might face issues with corrupted RTSP streams. A useful tip is to switch the encoder in the camera's settings to use H264 instead of H265, if available. Also, Reolink cameras may offer alternate video endpoints with the RTMP:// protocol, rather than RTSP://. Use the 'Add Camera' wizard in Agent DVR to explore these RTMP:// alternatives for potentially better results.

Stuttering Video? If you're noticing stuttering in live or recorded playback, especially with some Reolink cameras, here's a fix: edit the camera settings, go to the FFmpeg tab, and adjust the Max Delay (say, to 4 seconds) and Max Reorder Queue Size (around 500). These tweaks can help smooth out the frame delivery for a better viewing experience.

Resetting the Local Login

Forgot your local Agent DVR login? No worries, resetting it is a breeze and will revert it back to no login required:

  • First, let's stop Agent:
    • Windows: Go to Start, type "services.msc", find Agent in the list, right-click, and select 'Stop'.
    • Linux: Open a terminal and type sudo systemctl stop AgentDVR.service.
    • OSX: Open a terminal and run sudo launchctl unload -w /Library/LaunchDaemons/
  • Next, run the reset script. On Windows, it's agent-reset-local-login.bat. On Linux/OSX, use (don't forget to make it executable with chmod +x
  • Finally, restart Agent:
    • Windows: Open "services.msc", find Agent, right-click, and choose 'Start'.
    • Linux: In the terminal, run sudo systemctl start AgentDVR.service.
    • OSX: Use the terminal to run sudo launchctl load -w /Library/LaunchDaemons/

There you go! Your Agent DVR local login is reset and you can access it without needing to log in. Easy and secure!

Filter Applied