# Install the Collector on Linux

LLMS index: [llms.txt](/llms.txt)

---

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:

    <ul class="nav nav-tabs" id="tabs-0" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-00-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-00-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-00-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-00-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-0-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-00-00" role="tabpanel" aria-labelled-by="tabs-00-00-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_amd64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-01" role="tabpanel" aria-labelled-by="tabs-00-01-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_arm64.deb
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-02" role="tabpanel" aria-labelled-by="tabs-00-02-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt-get update
</span></span><span class="line"><span class="cl">sudo apt-get -y install wget
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.deb
</span></span><span class="line"><span class="cl">sudo dpkg -i otelcol_0.149.0_linux_386.deb
</span></span></code></pre></div>
    </div>
</div>


## RPM installation

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

    <ul class="nav nav-tabs" id="tabs-1" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-01-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-01-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-01-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-01-02" aria-selected="false">
        i386
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-1-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-01-00" role="tabpanel" aria-labelled-by="tabs-01-00-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_amd64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-01" role="tabpanel" aria-labelled-by="tabs-01-01-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_arm64.rpm
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-02" role="tabpanel" aria-labelled-by="tabs-01-02-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo yum update
</span></span><span class="line"><span class="cl">sudo yum -y install wget systemctl
</span></span><span class="line"><span class="cl">wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.rpm
</span></span><span class="line"><span class="cl">sudo rpm -ivh otelcol_0.149.0_linux_386.rpm
</span></span></code></pre></div>
    </div>
</div>


## Manual installation

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

     <ul class="nav nav-tabs" id="tabs-2" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-02-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-00" role="tab"
          data-td-tp-persist="amd64" aria-controls="tabs-02-00" aria-selected="true">
        AMD64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-01" role="tab"
          data-td-tp-persist="arm64" aria-controls="tabs-02-01" aria-selected="false">
        ARM64
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-02-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-02" role="tab"
          data-td-tp-persist="i386" aria-controls="tabs-02-02" aria-selected="false">
        i386
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-03-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-03" role="tab"
          data-td-tp-persist="ppc64le" aria-controls="tabs-02-03" aria-selected="false">
        ppc64le
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-2-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-02-00" role="tabpanel" aria-labelled-by="tabs-02-00-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_amd64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_amd64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-01" role="tabpanel" aria-labelled-by="tabs-02-01-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_arm64.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_arm64.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-02" role="tabpanel" aria-labelled-by="tabs-02-02-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_386.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_386.tar.gz
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-03" role="tabpanel" aria-labelled-by="tabs-02-03-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">curl --proto <span class="s1">&#39;=https&#39;</span> --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.149.0/otelcol_0.149.0_linux_ppc64le.tar.gz
</span></span><span class="line"><span class="cl">tar -xvf otelcol_0.149.0_linux_ppc64le.tar.gz
</span></span></code></pre></div>
    </div>
</div>


## 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:

```sh
/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:

```sh
sudo systemctl restart otelcol
```

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

```sh
sudo journalctl -u otelcol
```

[releases]:
  https://github.com/open-telemetry/opentelemetry-collector-releases/releases