Install the Collector on Linux

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.139.0/otelcol_0.139.0_linux_amd64.deb
sudo dpkg -i otelcol_0.139.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.139.0/otelcol_0.139.0_linux_arm64.deb
sudo dpkg -i otelcol_0.139.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.139.0/otelcol_0.139.0_linux_386.deb
sudo dpkg -i otelcol_0.139.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.139.0/otelcol_0.139.0_linux_amd64.rpm
sudo rpm -ivh otelcol_0.139.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.139.0/otelcol_0.139.0_linux_arm64.rpm
sudo rpm -ivh otelcol_0.139.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.139.0/otelcol_0.139.0_linux_386.rpm
sudo rpm -ivh otelcol_0.139.0_linux_386.rpm

Manual Linux installation

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

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

Automatic service configuration

By default, the otelcol systemd service starts with the --config=/etc/otelcol/config.yaml option after installation.

To use a different settings, set the OTELCOL_OPTIONS variable in the /etc/otelcol/otelcol.conf systemd environment file to the appropriate command-line options. You can run /usr/bin/otelcol --help to see all available options. You can pass additional environment variables to the otelcol service by adding them to this file.

If you modify the Collector configuration file or /etc/otelcol/otelcol.conf, restart the otelcol service to apply the changes by running:

sudo systemctl restart otelcol

To check the output from the otelcol service, run:

sudo journalctl -u otelcol

Last modified November 13, 2025: Solve The Confige: (3bb3cd6e)