Installation

Installation and troubleshooting guides

• Windows
• Linux
• Azure App Services
• macOS
• Docker
• Heroku
• AWS Elastic Beanstalk

Installation considerations

• In some cases running more than one type of APM agent can cause unexpected behavior. We recommend temporarily disabling or uninstalling other APM software.

• We recommend reviewing our Workflow guide to learn about best practices when using Raygun APM.

Transport Layer Security (TLS) Compliance

When sending events to Raygun, it is essential to ensure that your systems communicate using current Transport Layer Security (TLS) protocols and secure ciphers. Failure to comply with relevant security standards may result in event discarding at the gate. Raygun's ingestion nodes currently support TLS Versions 1.1, 1.2, and 1.3.

To guarantee successful communication, please follow these guidelines:

Supported TLS Versions and Ciphers

Events sent to Raygun must be transmitted using the following TLS versions:

• TLS 1.1
• TLS 1.2
• TLS 1.3

Ensure that your hosting Operating System supports an accepted set of TLS versions and ciphers. Refer to the documentation specific to your system for more information:

• Windows Server: TLS protocol version support
• Ubuntu: Troubleshooting TLS/SSL
• iOS, iPadOS, and macOS: TLS Security

Upgrading Raygun Crash Reporting Provider Versions

If you are using any of the following Raygun Crash Reporting Provider versions, make sure to upgrade them to a minimum version that offers TLS 1.1, TLS 1.2, and TLS 1.3 support:

• Serilog.Sinks.Raygun 5.3.3+
• Mindscape.Raygun4Net 6.0.3+
• Mindscape.Raygun4Net.Core 6.0.3+
• Mindscape.Raygun4Net.Mvc 6.0.3+
• Mindscape.Raygun4Net.WebApi 6.0.3+

Legacy C# Code Support

If you are working with legacy C# code that prevents you from updating the Raygun provider, you can enable support for TLS 1.1 or TLS 1.2 by adding the following code snippet in your main method:

using System.Net;

// Enable TLS 1.1 or TLS 1.2
ServicePointManager.SecurityProtocol |= (SecurityProtocolType.Tls11 | SecurityProtocolType.Tls12);

TLS Compatibility with Browsers

For crashes and errors occurring at end-users' devices, TLS limitations are less likely to be a concern. Modern browsers, when updated, automatically support the current TLS versions. To verify if a browser supports TLS 1.1, TLS 1.2, or TLS 1.3, refer to the following resources:

• TLS 1.1 support across browsers
• TLS 1.2 support across browsers
• TLS 1.3 support across browsers

By ensuring compliance with TLS protocols and adopting secure ciphers, you can securely transmit events to Raygun and effectively monitor crashes and errors in your applications.