Updating Images Addresses to Use ACR

last updated: june 25, 2025

To migrate the agent and executor containers, update the Docker Compose configuration to reference the Azure Container Registry.

Updating the Image Address

Template docker-compose.yml

YAML

services:
  d3agent:
    image: "d3soar.azurecr.io/d3prod/d3agent:<D3 vSOC version>"
    restart: always
    environment:
      - REMOTE_SERVER_URL=<D3 vSOC URL>
      - PROXY_IDENTITY=<D3 vSOC Agent Security Token>
      - PYTHON_REMOTE_URL=http://<Docker Host IP>:<Docker Host Port>/
      - PYTHON_REMOTE_GUID=<Executor Identifier>
      - SERVICE_DISPLAY_NAME=<Proxy Agent Display Name>
      - DOCKER_GID=<Docker Group ID>
      - DOCKER_PORT=<Docker Host Port>
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
  
  d3executor:
    image: "d3soar.azurecr.io/d3prod/d3executor:<D3 vSOC version>"
    privileged: true
    ports:
      - "<Docker Host Port>:9090"
    restart: always
    environment:
      - EXECUTOR_GUID=<Executor Identifier>

Modify the image field in docker-compose.yml:

Before (Google Container Registry)

example d3 agent image (old)

YAML

gcr.io/nimble-cortex-285618/d3prod/d3agent:16.8.409.0

example d3 executor image (old)

YAML

gcr.io/nimble-cortex-285618/d3prod/d3executor:16.8.409.0

After (Azure Container Registry)

example d3 agent image (new)

YAML

d3soar.azurecr.io/d3prod/d3agent:16.8.409.0

example d3 executor image (new)

YAML

d3soar.azurecr.io/d3prod/d3executor:16.8.409.0

Performing the Migration

Stop the running containers.
Bash
```
docker compose stop  
```
Pull the updated images from ACR.
Bash
```
docker compose pull  
```
Recreate the containers with the new images.
Bash
```
docker compose up -d --force-recreate  
```
Verify the migration by checking the container logs.
Bash
```
docker logs {container_id}  
```

Migration is successful if the logs contain:

"Starting server"
"heartbeat successful"