Install the Collector on Linux

You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.

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)