Skip to main content
This documentation explains how to install the AppSignal collector using a Linux package on the host you want to monitor. Select the Operating System your host uses from the navigation on the right to continue. Let us know if you want to run the collector on a distribution not listed here.

​
Debian

First, make sure the following packages are installed. All the following commands need root permissions.
The following releases are supported.
  • Bookworm for Debian 12 (x86_64 and arm64)
  • Bullseye for Debian 11 (x86_64)
Follow the instructions for your Debian version.
Import the GPG signing key by running this command:
Configure the package source by running this command:
Then, update apt to get the newly added packages and install the collector.
The collector has now been installed. Next up is configuring the collector so that AppSignal can receive data.

​
Ubuntu

First, make sure the following packages are installed. All the following commands need root permissions.
The following releases are supported.
  • Noble for Ubuntu 24.04 (x86_64 and arm64)
  • Jammy for Ubuntu 22.04 (x86_64)
Follow the instructions for your Ubuntu version.
Import the GPG signing key by running this command:
Configure the package source by running this command:
Then, update apt to get the newly added packages and install the collector.
The collector has now been installed. Next up is configuring the collector so that AppSignal can receive data.

​
Red Hat Enterprise Linux/CentOS

The following Red Hat releases are supported.
  • RHEL 9 (x86_64)
The following commands need root permissions. If you get a permission error, you may need to use sudo. Configure the package source by running this command:
Then, install the collector.
The collector has now been installed. Next up is configuring the collector so that AppSignal can receive data.

​
Configuration

The collector configuration can be found at /etc/appsignal-collector.conf. For a list of all the available options, see the configuration options page. Update the /etc/appsignal-collector.conf configuration file to use your organization’s Push API key. The required Push API key can be found in the “Push & Deploy” section for any app in your organization and in the “Add app” wizard for your organization.
For example:
Only the Push API key is required when configuring the collector. It will authorize your application data with our Push API. Once the configuration file is updated, you need to restart the collector.
The collector should now be running!

​
Upgrading

New releases include bug and security fixes, so keep AppSignal up to date. To update the collector, upgrade the package and restart it:
  • On Debian and Ubuntu, run apt-get update, then apt-get install --only-upgrade appsignal-collector.
  • On Red Hat Enterprise Linux, run dnf upgrade appsignal-collector.
Then run systemctl restart appsignal-collector.

​
Debugging

Check the log output with the following command to see if any problems have been reported.