# Install the Radiant Security Agent

The **Radiant Security Agent** securely collects and uploads logs from your internal network to Radiant Security’s S3 environment for advanced processing and analysis. By deploying the Radiant Agent, you can centralize log management, enhance security visibility, and ensure seamless data ingestion. The Radiant Agent uses a Docker-based installation, where the Agent runs as a container, simplifying deployment and maintenance.

In this guide, you'll deploy the Radiant Security Agent to securely collect and upload logs from your internal network to Radiant Security’s S3 environment for advanced processing and analysis. By deploying the Radiant Agent, you can centralize log management, enhance security visibility, and ensure seamless data ingestion.&#x20;

### Architecture

The following diagram shows how the Radiant Agent works:

<div align="left"><figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FoG0BF71rzlt3U1Km5JRZ%2FInstall%20The%20Radiant%20Agent_01.png?alt=media&#x26;token=62899c82-43b4-4466-aab5-9ff9a13d0368" alt=""><figcaption></figcaption></figure></div>

{% stepper %}
{% step %}

### Radiant Agent

The Radiant Agent listens on the specified connector ports to receive the incoming log data. In this example, the ports are for Fortinet (**TCP 5514**) and PaloAlto Networks (**TCP 5515**).
{% endstep %}

{% step %}

### Linux VM

Inside the **Linux VM**, a **Docker** container runs the **Radiant Agent** application, simplifying deployment and maintenance.
{% endstep %}

{% step %}

### Buffer Storage

The **Buffer Storage** temporarily stores log data to prevent any data loss during network interruptions when transferring data to AWS S3.
{% endstep %}

{% step %}

### 10x data compression

Data is transferred **up to 10x compression**, reducing bandwidth usage compared to syslog forwarding.
{% endstep %}

{% step %}

### AWS S3

The **AWS S3** bucket acts as the central repository for the collected data which Radiant Security then processes.
{% endstep %}
{% endstepper %}

### Prerequisites

The following prerequisites need to be met to install the Radiant Agent:

{% hint style="warning" %}
**Important note:** These prerequisites are based on a data volume of up to 1MB/s. If the data volume in your case is higher than this, please reach out to Radiant regarding updated specs.
{% endhint %}

#### **Host OS Requirements**

* [ ] Linux Ubuntu or RHEL
* [ ] Root permissions required for installation, setting up OS service, etc. (installing software, setting up OS service)
* [ ] High-performance storage (Recommended 200GB)

**Compute Requirements**

* [ ] 4 CPUs and 8GB memory for handling 1MB/s data load
* [ ] Docker version 20.10.x or newer (installation script will update if needed)

**Network Requirements**

* [ ] Ensure outbound traffic to:
  * `sts.amazonaws.com:443`
  * `sts.us-west-2.amazonaws.com:443`
  * `s3.us-west-2.amazonaws.com:443`
  * `*.s3.us-west-2.amazonaws.com:443`\
    **Protocol:** HTTPS (TCP/443)
* [ ] Each connector type requires a dedicated port (e.g. Fortinet on 5514, Palo on 5515, etc)<br>

### Next Steps

To set up a Radiant Agent or if you have any questions, please reach out to our Product and Customer Success teams at <support@radiantsecurity.ai>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.radiantsecurity.ai/radiant-connectors/data-connectors/install-the-radiant-security-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
