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.

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.128.0/otelcol_0.128.0_linux_amd64.deb
sudo dpkg -i otelcol_0.128.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.128.0/otelcol_0.128.0_linux_arm64.deb
sudo dpkg -i otelcol_0.128.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.128.0/otelcol_0.128.0_linux_386.deb
sudo dpkg -i otelcol_0.128.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.128.0/otelcol_0.128.0_linux_amd64.rpm
sudo rpm -ivh otelcol_0.128.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.128.0/otelcol_0.128.0_linux_arm64.rpm
sudo rpm -ivh otelcol_0.128.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.128.0/otelcol_0.128.0_linux_386.rpm
sudo rpm -ivh otelcol_0.128.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.128.0/otelcol_0.128.0_linux_amd64.tar.gz
tar -xvf otelcol_0.128.0_linux_amd64.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.128.0/otelcol_0.128.0_linux_arm64.tar.gz
tar -xvf otelcol_0.128.0_linux_arm64.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.128.0/otelcol_0.128.0_linux_386.tar.gz
tar -xvf otelcol_0.128.0_linux_386.tar.gz
curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.128.0/otelcol_0.128.0_linux_ppc64le.tar.gz
tar -xvf otelcol_0.128.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