---
title: Build Datadog Agent image
description: Instructions for building custom Datadog Agent Docker images from source code
breadcrumbs: Docs > Containers > Containers Guides > Build Datadog Agent image
---

# Build Datadog Agent image

Follow the instructions below to build the Datadog Docker Agent image for a given `<AGENT_VERSION>` Agent version (above v6.0).

1. Clone the Datadog Agent repository:

   ```shell
   git clone https://github.com/DataDog/datadog-agent.git
   ```

1. Go into the `datadog-agent/Dockerfiles/agent/` folder:

   ```shell
   cd datadog-agent/Dockerfiles/agent/
   ```

1. Switch to the Agent version branch you want to build the Agent from:

   ```shell
   git branch <AGENT_VERSION> && git checkout <AGENT_VERSION>
   ```

1. Download the Agent Debian package that corresponds to the Agent version you want. Choose between the AMD and ARM architecture:

   {% tab title="AMD" %}

   ```shell
   curl https://s3.amazonaws.com/apt.datadoghq.com/pool/d/da/datadog-agent_<AGENT_VERSION>-1_amd64.deb -o datadog-agent_<AGENT_VERSION>-1_amd64.deb
   ```

   {% /tab %}

   {% tab title="ARM" %}

   ```shell
   curl https://s3.amazonaws.com/apt.datadoghq.com/pool/d/da/datadog-agent_<AGENT_VERSION>-1_arm64.deb -o datadog-agent_<AGENT_VERSION>-1_arm64.deb
   ```

   {% /tab %}

**Note**: The full list of Debian packages available can be found [on this APT listing](http://apt.datadoghq.com/pool/d/da/).

1. Build the Agent image by running:

   {% tab title="AMD" %}

   ```shell
   docker build --build-arg <BUILD_ARGS> --file amd64/Dockerfile --pull --tag <IMAGE_TAG> .
   ```

   {% /tab %}

   {% tab title="ARM" %}

   ```shell
   docker build --build-arg <BUILD_ARGS> --file arm64/Dockerfile --pull --tag <IMAGE_TAG> .
   ```

   {% /tab %}

For instance to build the Agent version 7.17.0 on the AMD architecture you would run:

   ```shell
   docker build --build-arg DD_AGENT_ARTIFACT=./datadog-agent_7.17.0-1_amd64.deb --file amd64/Dockerfile --pull --tag documentation-example .
   ```

Available `<BUILD_ARGS>` are:

| Argument          | Definition                                                                  | Default |
| ----------------- | --------------------------------------------------------------------------- | ------- |
| PYTHON_VERSION    | The Python runtime version for your Agent check.                            | `-`     |
| WITH_JMX          | If set to `true`, the Agent container contains the JMX fetch logic.         | `false` |
| DD_AGENT_ARTIFACT | Path to the Agent Debian artifact package to use if not in the same folder. | `-`     |