Getting Started with Agent DVR

About

Agent DVR is a standalone replacement for iSpy that runs as a service, uses less CPU and features a web user interface that is accessible from anywhere with no port forwarding required!

We recommend that you use either iSpy or Agent - you can use both but it may cause issues with device drivers and network access.

Tip: Click the button above to show the userguide index.

Installing

Download Agent DVR from here and run the installer. Agent runs as a console application (or as a service on Windows) on Windows 7+, Linux X64 (tested with Ubuntu 18.04+) and OSX 64.

Follow the setup instructions on the download page

Once Agent is running, you can access it via most web browsers at http://localhost:8090. Some web browsers (notably Firefox) require a media permission to start WebRTC which is needed to communicate with the Agent service. Just the permission is required - Agent won't actually use it. If you decline the permission and Agent fails to connect you'll need to grant it and click on Reload. You can grant the permission by clicking on the icons to the left of the Address bar in the web browser.

If the installer fails to complete you can run Agent from a command prompt by running Agent.exe in the install folder and it should tell you what the issue is.

Remote Access

Agent DVR uses WebRTC to setup remote connections so doesn't require any port forwarding setup and will work even over mobile internet connections. To connect remotely you will need to pair Agent with your iSpyConnect account. To do this, click on the account icon in the local web interface and "Remote Access". You'll be redirected to the online portal.

Important: You do not need to install Agent DVR on other computers or setup port forwarding for remote access. Just open up a web browser on any device at https://www.ispyconnect.com/app once Agent is connected. Remote access to Agent is a subscription service.

Just Subscribed?:

No UI?: If you have downloaded Agent DVR to a VPS or a PC with no graphical UI you can still setup Agent for remote access by calling "Agent.exe register" on Windows or "dotnet Agent.dll register" on Linux/ OSX. This will give you a claim code you can use to access Agent from another PC.

Can't connect?: In rare instances a connection may fail due to content filtering on a VPN connection. You'll need to add exceptions in your content filtering software for *.ispyconnect.com and agentrtc.azurewebsites.net

LAN Access

To access Agent over your LAN you will need to open up the port Agent is using in your Firewall for your local network (default is port 8090). When you have done this you can browse to Agent at http://IPADDRESS:8090 (where IPADDRESS is the IP address of the computer running agent - for example, 192.168.1.2).

To secure LAN access set a username and password in Server Settings - Local Server. If you forget this password you can reset it by stopping Agent and calling "Agent.exe reset-local-login" on Windows or "dotnet Agent.dll reset-local-login" on OSX and Linux.

Agent uses webrtc which uses random ports to connect over the network. This can cause issues if you have a firewall or antivirus blocking incoming connections. Webrtc generally uses ports over 50000 so if you have problems connecting over the local network try allowing a LAN port range of 50000 - 65535 in your firewall (or use our website).

Some browser extensions can also block access so if you have issues connecting locally try a different browser (Safari, Chrome, Firefox and the latest version of Edge should all work). Also try disabling any extensions and clearing your cache.

Uninstalling

If Agent is running as a service then stop the service (by clicking start - run and enter "services.msc". Find Agent in the list, right click it and click stop) and run agent-uninstall-service.bat in the Agent directory.

To remove Agent just delete the Agent directory (Agent is a portable application so doesn't install into the add/remove programs list in Windows). By default Agent is installed to C:\Program Files\Agent on Windows

Switching Accounts

Save your configuration from the Server menu using the Import/Export option. Then stop the Agent service and run the agent-reset.bat or agent-reset.sh command. Start Agent again and load back in your configuration and then click on Remote Access under the Server menu to connect to your new account.

Using Agent

Agent does not have a windows forms user interface like iSpy does. The user interface is all browser based via the local portal, web portal or mobile applications

Agent runs it's own webserver. By default this is running at http://localhost:8090 on the PC running Agent (although it may be using a different port if that wasn't available or was changed when it was installed - see the link "Agent UI" on the desktop on Windows).

Once you have the local UI open you can start adding devices to Agent - see the edit icon to get started.

Agent has help built into it - click on the "?" icon at top right to access videos and other help resources.

Camera Framerates

By default Agent DVR has quite low default framerates. This is to minimise the CPU usage on the computer running Agent and maximise the number of cameras it can support. You can modify the camera framerate by editing the camera and setting the "max framerate" on the General tab and on the Recording tab. There's also a global framerate limit for the web application under Server - Settings - Playback.