Video Surveillance Software

• Open up a terminal and go to the directory you want to install Agent DVR. The install script will create a folder called "AgentDVR". This script works on macOS (>= 10.14) and most versions of 64 bit Linux (Supported ARM 32 and 64 bit for Raspberry Pi).
• Copy and paste this setup script into your terminal and press Enter (you may need to install curl first on Linux - run "sudo apt-get install curl"):

  bash <(curl -s "https://raw.githubusercontent.com/ispysoftware/agent-install-scripts/main/install.sh")

• Install may take a while as it will need to download and build FFMPEG. You may need to enter your password as part of the build process.
• For install related bug reports please see our issues tracker. For issues with AgentDVR itself please see our Reddit forums
• Open a web browser at http://localhost:8090 to start configuring Agent.
• If the service fails to start, run Agent manually to see what the problem is:
  • On macOS: run "dotnet Agent.dll" in the AgentDVR folder
  • On Linux: run "./start_agent.sh" in the AgentDVR parent folder

• We recommend backing up your configuration before updating Agent - click on the Server Icon , Backup/ Restore and download your devices and configuration files.
  The recommended way to update Agent is via the remote web portal. Click on the Server icon . If an update is available there will be a button under Logs to start the update process.

  To manually update to the latest version use the link below to download the latest version for your platform in a zip file (unzip over the top of the existing install and restart Agent DVR to upgrade):

  bash <(curl -s "https://raw.githubusercontent.com/ispysoftware/agent-install-scripts/main/download.sh")

• A Docker image of Agent DVR will install Agent DVR on a virtual Linux image on any supported operating system (currently only x86 based processors, ARM not supported). Please see the docker file for options.

  Important: The docker version of Agent includes a TURN server to work around port access limitations on Docker. If Docker isn't running in Host mode (which is only available on linux hosts) then you will need to access the UI of Agent by http://IPADDRESS:8090 instead of http://localhost:8090 (where IPADDRESS is the LAN IP address of your host computer).

  To install Agent under docker you can call (for example):
  
  docker run -it -p 8090:8090 -p 3478:3478/udp -p 50000-50010:50000-50010/udp \ -v /appdata/ispyagentdvr/config/:/agent/Media/XML/ \ -v /appdata/ispyagentdvr/media/:/agent/Media/WebServerRoot/Media/ \ -v /appdata/ispyagentdvr/commands:/agent/Commands/ \ -e TZ=America/Los_Angeles \ --name agentdvr doitandbedone/ispyagentdvr

  To run Agent if it's already installed:
  
  docker start agentdvr

  ---

  An nVidia compatible docker install is also available. This requires more setup than the standard docker install and is recommended for advanced users only. Please read the instructions on the docker page:
  Docker File (with nVidia support)

• Docker File

We've open sourced our Agent Plugins to help you get started building on top of our software. Check out our Github repo at https://github.com/ispysoftware/AgentDVR-Plugins.

Some of the things you can do with plugins:

• Process live video and audio
• Add overlays and audio effects
• Trigger alerts and detection events
• Create your own custom events to trigger Actions with extended parameters
• Tag recordings
• Call back into the Agent API by using HttpClient.