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. 
sudo apt update
sudo apt install curl gpg -y
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:
curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bookworm/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg
Configure the package source by running this command:
echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bookworm/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-debian-bookworm.list
Then, update apt to get the newly added packages and install the collector. 
apt-get update
apt-get install appsignal-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. 
sudo apt update
sudo apt install curl gpg -y
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:
curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-noble/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg
Configure the package source by running this command:
echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-noble/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-ubuntu-noble.list
Then, update apt to get the newly added packages and install the collector. 
apt-get update
apt-get install appsignal-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: 
sh -c 'echo -e "[collector-rpm-9]\nname=Collector RPM 9 \nbaseurl=https://packages.buildkite.com/appsignal/collector-rpm-9/rpm_any/rpm_any/\$basearch\nenabled=1\nrepo_gpgcheck=1\ngpgcheck=0\ngpgkey=https://packages.buildkite.com/appsignal/collector-rpm-9/gpgkey\npriority=1"' > /etc/yum.repos.d/collector-rpm-9.repo
Then, install the collector. 
dnf install -y appsignal-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. 
# /etc/appsignal-collector.conf
push_api_key = "<YOUR PUSH API KEY>"
For example: 
# /etc/appsignal-collector.conf
push_api_key = "0000-0000-0000-0000"
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. 
systemctl restart appsignal-collector
The collector should now be running!

​
Debugging

Check the log output with the following command to see if any problems have been reported. 
journalctl -u appsignal-collector