Skip to main content
Skip table of contents

‎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.

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

    BASH
    mkdir DemoD3AgentDirectory
  2. Change to the newly created directory:

    BASH
    cd DemoD3AgentDirectory
  3. Copy the service_account_d3soar.key file into the newly created directory.

  4. 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
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.