Linux Environment Setup
LAST UPDATED: FEB 11, 2025
System Requirements and Network Configuration
Hardware (Can be virtual)
Component | Minimum | Recommended |
---|---|---|
CPU | 4 CPU Cores | 8 CPU Cores |
Memory | 8GB RAM | 16GB RAM |
Host Local Storage | 30GB SSD | 100GB SSD (Raid 1 or 10) |
Operating System
Version | License |
---|---|
Linux Ubuntu / Red Hat | - |
Firewall Ports
Service | Protocol | Port | Direction | Firewall / Proxy |
---|---|---|---|---|
D3 SOAR Proxy Agent | TCP | 443 | Outbound to Internet | Allow |
READER NOTE
The server for D3 Proxy Agent must be able to communicate with D3 vSOC servers via TCP ports 443.
D3 Proxy Agent must be installed on servers that have direct access to the internal security products, such as firewalls, SIEM, Exchange, etc.
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
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:
docker-ce-cli
docker-ce
http://containerd.io
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:
docker-ce-cli
docker-ce
http://containerd.io
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.
Contact a D3 account representative to obtain the
service_account.key
file. Ensure that the file name remains asservice_account.key
without any appended parentheses or numbers.Create a directory for the D3 Agent installation on the Linux host machine:
BASHmkdir DemoD3AgentDirectory
Change to the newly created directory:
BASHcd DemoD3AgentDirectory
Copy the
service_account.key
file into the newly created directory.Authenticate to the Azure Container Registry using the following command:
BASHsudo docker login -u d3acrpull --password-stdin https://d3soar.azurecr.io < service_account.key