‎Linux Environment Setup

LAST UPDATED: APR 7, 2025

System Requirements and Network Configuration

Hardware (Can be virtual)

Operating System

Firewall Ports

READER NOTE

1. The server for D3 Proxy Agent must be able to communicate with D3 vSOC servers via TCP ports 443.

2. D3 Proxy Agent must be installed on servers that have direct access to the internal security products, such as firewalls, SIEM, Exchange, etc.

3. If Web Proxy is enabled in your network environment, Web Proxy IP needs to be provided for docker-compose configuration during the installation. See Using D3 Proxy Agent with a Web Proxy Server).

Docker Engine Installation

Installing Docker on Ubuntu

Follow the instructions from the documentation to install docker using the apt package manager: Install Docker Engine on Ubuntu | Docker Docs

1. Run the command below to check if Docker is installed:

docker version

Alternatively, you can install from a package with these instructions:

You can find different Ubuntu releases for Docker at https://download.docker.com/linux/ubuntu/dists/

Download and install four .deb packages from <version>/pool/stable/amd64:

1. docker-ce-cli

2. docker-ce

3. http://containerd.io

4. docker-compose-plugin

Command to install on ubuntu:

sudo dpkg -i /path/to/<replace_with_package>.deb

Command to check if docker service is running:

sudo systemctl status docker

Installing Docker on Red Hat

Follow the instructions from the documentation to install docker using the yum package manager: https://docs.docker.com/engine/install/rhel/

Alternatively, you can install from a package with these instructions:

Click here for Red Hat package distributions

Download and install four .rpm packages from <version>/s390x/stable/packages:

1. docker-ce-cli

2. docker-ce

3. http://containerd.io

4. docker-compose-plugin

Command to install on Red Hat:

sudo yum install /path/to/<replace_with_package>.rpm  

Command to start docker server:

sudo systemctl start docker

Authenticating to Azure Container Registry

The D3 Agent image hosted on Azure Container Registry is private. Authenticate to the D3 Azure Container Registry to pull and install it.

1. Contact a D3 account representative to obtain the service_account_d3soar.key file. Ensure that the file name remains as service_account_d3soar.key without any appended parentheses or numbers.

2. Create a directory for the D3 Agent installation on the Linux host machine:

   BASH

   mkdir DemoD3AgentDirectory

3. Change to the newly created directory:

   BASH

   cd DemoD3AgentDirectory

4. Copy the service_account_d3soar.key file into the newly created directory.

5. Authenticate to the Azure Container Registry using the following command:

   BASH

   sudo docker login -u d3acrpull --password-stdin https://d3soar.azurecr.io < service_account_d3soar.key