> For the complete documentation index, see [llms.txt](https://siff.gitbook.io/siff/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://siff.gitbook.io/siff/installation/collector-installation.md).

# Collector Installation

This document covers installation of the Collector. For more information on Collectors and how they fit into the SIFF Platform refer to the [Collectors & Agents](https://docs.siff.io/getting_started/collectors-and-agents) section in Getting Started.

## Download / Install <a href="#download-install" id="download-install"></a>

### Linux

**Note:** To add a repository and install packages sudo or root access is required.

#### Install via Package Repository <a href="#install-via-package-repository" id="install-via-package-repository"></a>

* For **yum** (rpm) based distributions:
  1. Download the appropriate repository file for your system. Refer to the [SIFF Repositories](https://docs.siff.io/install/collector/#siff-repositories) table below.
  2. Install the repository file: copy the `.repo` file to `/etc/yum.repos.d/`.
  3. Update the packages: run `sudo yum update`
  4. Install the Collector package: run `sudo yum install siff-collector`

<br>

* For **apt** (deb) based distributions:
  1. Install the SIFF repository signing key:\
     `curl https://downloads.siff.io/repo/deb/repo/conf/siff.gpg.key | sudo apt-key add -`
  2. Download the appropriate repository file for your system. Refer to the [SIFF Repositories](https://docs.siff.io/install/collector/#siff-repositories) table below.
  3. Install the repository file: copy the `.list` file to `/etc/apt/sources.list.d/`.
  4. Update the packages: run `sudo apt-get update`
  5. Install the Collector package: run `sudo apt-get install siff-collector`

**SIFF Repositories**

| Distribution                           | Architecture | Type | Repository                                                                |
| -------------------------------------- | ------------ | ---- | ------------------------------------------------------------------------- |
| RHEL 8                                 | x86\_64      | yum  | [siff\_rhel\_8.repo](https://downloads.siff.io/repo/siff_rhel_8.repo)     |
| RHEL 7                                 | x86\_64      | yum  | [siff\_rhel\_7.repo](https://downloads.siff.io/repo/siff_rhel_7.repo)     |
| RHEL 6                                 | x86\_64      | yum  | [siff\_rhel\_6.repo](https://downloads.siff.io/repo/siff_rhel_6.repo)     |
| CentOS 8                               | x86\_64      | yum  | [siff\_centos\_8.repo](https://downloads.siff.io/repo/siff_centos_8.repo) |
| CentOS 7                               | x86\_64      | yum  | [siff\_centos\_7.repo](https://downloads.siff.io/repo/siff_centos_7.repo) |
| CentOS 6                               | x86\_64      | yum  | [siff\_centos\_6.repo](https://downloads.siff.io/repo/siff_centos_6.repo) |
| Amazon Linux, Amazon Linux 2           | x86\_64      | yum  | [siff\_amzn2.repo](https://downloads.siff.io/repo/siff_amzn2.repo)        |
| Ubuntu LTS: 16.04, 18.04, 20.04, 22.04 | x86\_64      | apt  | [siff.list](https://downloads.siff.io/repo/siff.list)                     |

#### Manual Installation <a href="#manual-installation" id="manual-installation"></a>

For systems that cannot access the package repository directly then the latest package can be downloaded and installed manually:

1. Download the appropriate package for your system:
   * .rpm (RedHat, CentOS, Amazon Linux): [**siff-collector-latest.x86\_64.rpm**](https://downloads.siff.io/repo/rpm/siff-collector-latest.x86_64.rpm)
   * .deb (Ubuntu): [**siff-collector.deb**](https://downloads.siff.io/repo/deb/siff-collector.deb)
2. Copy the package to the target system
3. Install the package:
   * .rpm: `sudo rpm -Uvh siff-collector-latest.x86_64.rpm`
   * .deb: `sudo dpkg -i siff-collector.deb`

### Windows

**Note:** For Windows installation the collector configuration can be provided during install time. To use this option make sure to have a copy of `collector.yml` before running the installer (see Configure below)

1. Download the Windows installer: [**siffcollector-latest.exe**](https://downloads.siff.io/repo/windows/siffcollector-latest.exe)
2. Run the installer to complete the installation.

### MacOS

1. Download the macOS installer: [**siff-collector-latest.img**](https://downloads.siff.io/repo/macos/siff-collector-latest.img)
2. Run the installer to complete the installation.