> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collector Linux package installation

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](mailto:support@appsignal.com) 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.

<CodeGroup>
  ```bash Shell theme={null}
  sudo apt update
  sudo apt install curl gpg -y
  ```
</CodeGroup>

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.

<Tabs>
  <Tab title="Bookworm">
    Import the GPG signing key by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bookworm/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bookworm-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure the package source by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      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
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Bullseye">
    Import the GPG signing key by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-debian-bullseye/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure the package source by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bullseye/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-debian-bullseye-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-debian-bullseye/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-debian-bullseye.list
      ```
    </CodeGroup>
  </Tab>
</Tabs>

Then, update apt to get the newly added packages and install the collector.

<CodeGroup>
  ```bash Shell theme={null}
  apt-get update
  apt-get install appsignal-collector
  ```
</CodeGroup>

The collector has now been installed. Next up is [configuring the collector](#configuration) so that AppSignal can receive data.

## Ubuntu

First, make sure the following packages are installed. All the following commands need root permissions.

<CodeGroup>
  ```bash Shell theme={null}
  sudo apt update
  sudo apt install curl gpg -y
  ```
</CodeGroup>

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.

<Tabs>
  <Tab title="Noble">
    Import the GPG signing key by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-noble/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-noble-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure the package source by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      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
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Jammy">
    Import the GPG signing key by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      curl -fsSL "https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/gpgkey" | gpg --dearmor -o /etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg
      ```
    </CodeGroup>

    Configure the package source by running this command:

    <CodeGroup>
      ```sh Shell theme={null}
      echo -e "deb [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/appsignal_collector-ubuntu-jammy-archive-keyring.gpg] https://packages.buildkite.com/appsignal/collector-ubuntu-jammy/any/ any main" > /etc/apt/sources.list.d/buildkite-appsignal-collector-ubuntu-jammy.list
      ```
    </CodeGroup>
  </Tab>
</Tabs>

Then, update apt to get the newly added packages and install the collector.

<CodeGroup>
  ```bash Shell theme={null}
  apt-get update
  apt-get install appsignal-collector
  ```
</CodeGroup>

The collector has now been installed. Next up is [configuring the collector](#configuration) so that AppSignal can receive data.

## Red Hat Enterprise Linux/CentOS

The following [Red Hat releases](https://access.redhat.com/support/policy/updates/errata/) 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:

<CodeGroup>
  ```sh Shell theme={null}
  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
  ```
</CodeGroup>

Then, install the collector.

<CodeGroup>
  ```bash Shell theme={null}
  dnf install -y appsignal-collector
  ```
</CodeGroup>

The collector has now been installed. Next up is [configuring the collector](#configuration) 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](/collector/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](https://appsignal.com/redirect-to/app?to=info) for any app in your organization and in the ["Add app" wizard](https://appsignal.com/redirect-to/organization?to=sites/new) for your organization.

<CodeGroup>
  ```toml Config file theme={null}
  # /etc/appsignal-collector.conf
  push_api_key = "<YOUR PUSH API KEY>"
  ```
</CodeGroup>

For example:

<CodeGroup>
  ```toml Config file theme={null}
  # /etc/appsignal-collector.conf
  push_api_key = "0000-0000-0000-0000"
  ```
</CodeGroup>

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.

<CodeGroup>
  ```sh Shell theme={null}
  systemctl restart appsignal-collector
  ```
</CodeGroup>

The collector should now be running!

## Debugging

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

<CodeGroup>
  ```sh Shell theme={null}
  journalctl -u appsignal-collector
  ```
</CodeGroup>