1. Home
  2. Product Guides
  3. APM
  4. Agent installation
  5. Linux

Linux

The Raygun APM Linux Agent supports AMD64 and ARM64 on glibc-based Linux distributions with glibc 2.27 or newer. Alpine and other musl-based distributions are not supported. Amazon Linux 2023 is supported; Amazon Linux 2 is not supported because it provides glibc 2.26.

The installer detects the host architecture, verifies the release SHA-256, installs the matching self-contained Agent, native .NET profiler, and managed startup hook, and starts the Agent with systemd, OpenRC, or SysV init.

The host must provide OpenSSL 1.1 or 3. The installer adds the required OpenSSL and CA certificate packages when it can use apt-get, dnf, or yum.

Run the following command with root privileges:

curl -fsSL https://downloads.raygun.com/apm/install.sh | sudo sh

The installer does not accept or store an application API key and does not modify or restart applications. Each profiled application must receive its own API key, profiler environment variables, and DOTNET_STARTUP_HOOKS value printed by the installer.

Pass --version when a deployment must use an exact published release:

curl -fsSL https://downloads.raygun.com/apm/install.sh \
  | sudo sh -s -- --version 3.1.3

Use --no-start to install the files without changing the host's init configuration or starting the Agent.

The installer uses versioned release directories and an atomic current selector:

/opt/raygun/agent/releases/<version>-<architecture>/
/opt/raygun/agent/current -> releases/<version>-<architecture>
/opt/raygun/agent/current/Profiler/RaygunProfiler.so
/opt/raygun/agent/current/StartupHook/Raygun.Apm.StartupHook.dll
/etc/raygun/agent.env
/var/lib/raygun-agent/
/var/log/raygun-agent/

Application configuration must reference /opt/raygun/agent/current, not a versioned release directory. This allows an Agent upgrade to switch the application to the new profiler and startup hook after the application is restarted.

For systemd hosts:

sudo systemctl status raygunagent
curl -fsS http://127.0.0.1:18100/status

Use sudo service raygunagent status on OpenRC or SysV hosts. The health response must report that the Agent is running.

The Agent, profiler, and startup-hook files are now installed, but applications are not profiled automatically. Configure and restart each application by following .NET on Linux profiler setup.

If traces do not appear, see Linux troubleshooting.

On this page: