Installation

Agent downloads

Download links for each version of the Raygun Agent can be found on the downloads page.

All links used below will always refer to the latest version.

Installing on Linux

Follow these steps to install the Raygun Agent on a Linux x64 machine (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu and derivatives are supported).

The Raygun Agent is built as a self-contained .NET Core application. The .NET Core runtime doesn’t need to be installed on the target machine.

1. Install dependencies

Ensure you have the dependencies needed to run the commands below.

sudo apt-get -y install unzip wget

2. Create a user account

Create a user account to run the Raygun Agent and configure a directory for logs and configuration settings.

sudo adduser --disabled-password --gecos '' raygun
sudo mkdir /usr/share/Raygun
sudo chown -R raygun:raygun /usr/share/Raygun

3. Download and extract the agent

Create a directory to install the Raygun Agent to (change this to what works best for you). Then download the Raygun Agent zip file to that directory and give execute permission to the Agent and CLI executables.

sudo mkdir /var/raygun
sudo chown -R raygun:raygun /var/raygun

sudo wget https://downloads.raygun.com/APM/latest/RaygunAgent-netcoreapp2.0-linux-x64.zip
sudo unzip -d /var/raygun/agent -o RaygunAgent-netcoreapp2.0-linux-x64.zip
sudo rm RaygunAgent-netcoreapp2.0-linux-x64.zip
sudo chmod +x /var/raygun/agent/RaygunAgent
sudo chmod +x /var/raygun/agent/rgc

4. Run the agent

Run the agent in the terminal using the raygun user account, logging output to the terminal. Make sure you enter your API key below. You API key can be found on the setup instructions page when creating a new application in Raygun.

sudo -u raygun /var/raygun/agent/RaygunAgent -logger stdout -register [YOUR-API-KEY]

Installing on Windows (MSI)

Follow these steps to install the Raygun Agent on Windows Server 2008 or above using the MSI installer.

The Raygun APM Agent can be scripted to install silently, see the scripted installation instructions.

1. Download and install

Download the MSI installer to your server. Run the installer follow the on-screen prompts to complete installation.

Windows 64-bit - Installer for the 32-bit and 64-bit profiler and agent.
Windows 32-bit - Installer for the 32-bit profiler only and agent.

2. Run the agent

When installing with the MSI installer the Raygun Agent is configured as a Windows Service set to auto-start. When the installer completes, the agent will be running.

To configure the agent and your application please check the setup instructions for your application.


Installing on Windows (.NET Core)

Follow these steps to install the Raygun Agent on a Windows Server using .NET Core.

1. Install dependencies

The Raygun Agent has not been built self-contained as we assume you already have the .NET Core runtime installed. If required, download and install the .NET Core 2.0 runtime.

2. Download and extract the agent

Create a directory to install the Raygun Agent to (change this to what works best for you). Then download the Raygun Agent zip file to that directory.

$installto = "${env:ProgramFiles}\Raygun\RaygunAgent\"

New-Item -Path $installto -ItemType "directory"
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -Uri "https://downloads.raygun.com/APM/latest/RaygunAgent-netcoreapp2.0.zip" -OutFile "${installto}\RaygunAgent-netcoreapp2.0.zip"
Add-Type -assembly "system.io.compression.filesystem"
[io.compression.zipfile]::ExtractToDirectory("${installto}\RaygunAgent-netcoreapp2.0.zip", $installto)
Remove-Item "${installto}\RaygunAgent-netcoreapp2.0.zip"

3. Run the agent

Run the agent in the console, logging output to the console. Make sure you enter your API key below. You API key can be found on the setup instructions page when creating a new application in Raygun.

dotnet "${env:ProgramFiles}\Raygun\RaygunAgent\RaygunAgent.dll" -logger stdout -register [YOUR-API-KEY]