‎Linux Environment Setup

LAST UPDATED: APR 24, 2025

To properly configure the Linux environment, follow the below steps:

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. Install Docker on Ubuntu or Red Hat.

3. Authenticate to the Azure Container Registry to gain access for pulling the D3 Agent image.

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:

BASH

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:

BASH

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

Command to check if docker service is running:

BASH

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:

BASH

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

Command to start docker server:

BASH

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. Ensure that the service_account_d3soar.key file has been obtained from D3.

CONTACT D3 *

Contact D3 Support at d3support@d3security.com.

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