Install the Collector on Linux

Every Collector release includes APK, DEB and RPM packaging for Linux amd64/arm64/i386 systems. You can find the default configuration in /etc/otelcol/config.yaml after installation.

Note: systemd is required for automatic service configuration.

DEB installation

To get started on Debian systems, run the following commands:

sudo apt-get update
sudo apt-get -y install wget
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_amd64.deb
sudo dpkg -i otelcol_0.143.0_linux_amd64.deb
sudo apt-get update
sudo apt-get -y install wget
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_arm64.deb
sudo dpkg -i otelcol_0.143.0_linux_arm64.deb
sudo apt-get update
sudo apt-get -y install wget
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_386.deb
sudo dpkg -i otelcol_0.143.0_linux_386.deb

RPM installation

To get started on Red Hat systems, run the following commands:

sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_amd64.rpm
sudo rpm -ivh otelcol_0.143.0_linux_amd64.rpm
sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_arm64.rpm
sudo rpm -ivh otelcol_0.143.0_linux_arm64.rpm
sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_386.rpm
sudo rpm -ivh otelcol_0.143.0_linux_386.rpm

Manual installation

Linux releases are available for various architectures. You can download the binary file and install it on your machine manually:

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_amd64.tar.gz
tar -xvf otelcol_0.143.0_linux_amd64.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_arm64.tar.gz
tar -xvf otelcol_0.143.0_linux_arm64.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_386.tar.gz
tar -xvf otelcol_0.143.0_linux_386.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.143.0/otelcol_0.143.0_linux_ppc64le.tar.gz
tar -xvf otelcol_0.143.0_linux_ppc64le.tar.gz

Automatic service configuration

When the OpenTelemetry Collector runs as a systemd service, it starts with the /etc/otelcol/config.yaml configuration file by default.

If you want to change this setting, you can edit the OTELCOL_OPTIONS variable in the systemd environment file, /etc/otelcol/otelcol.conf. You can also define additional environment variables for the otelcol service in the same file. For a complete list of supported options, run the following command:

/usr/bin/otelcol --help

If you modify the Collector configuration file (config.yaml) or the environment file (otelcol.conf), you must restart the service to apply the changes:

sudo systemctl restart otelcol

To check the log output from the otelcol service, run:

sudo journalctl -u otelcol