> 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/agent-installation.md).

# Agent Installation

This document covers installation of the Agent. For more information on Agents 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/agent/#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 Agent package: run `sudo yum install siff-agent`

<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/agent/#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 Agent package: run `sudo apt-get install siff-agent`

**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-agent-latest.x86\_64.rpm**](https://downloads.siff.io/repo/rpm/siff-agent-latest.x86_64.rpm)
   * .deb (Ubuntu): [**siff-agent.deb**](https://downloads.siff.io/repo/deb/siff-agent.deb)
2. Copy the package to the target system
3. Install the package:
   * .rpm: `sudo rpm -Uvh siff-agent-latest.x86_64.rpm`
   * .deb: `sudo dpkg -i siff-agent.deb`

### Windows

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