Install the Datadog Agent Integration Developer Tool
This document covers how to setup a Python environment to work on Agent-based Integrations, including installing the interpreter and developer tool.
Install Python
Many operating systems come with a pre-installed version of Python. However, the version of Python installed by default may not be the same as the one used by the latest Agent. To ensure that you have everything you need to get an integration running, install a dedicated Python interpreter.
Install Python 3.12 using Homebrew:
Update Homebrew:
Install Python:
Check the Homebrew installation output and run any additional commands recommended by the installation script.
Verify that the Python binary is installed in your PATH and that have installed the correct version:
You should see the following output depending on your Mac architecture:
- ARM (M1+) machines:
/opt/homebrew/bin/python3.12
- MacOS on Intel machines:
/usr/local/bin/python3.12
- Download the Python 3.12 64-bit executable installer and run it.
- Select the option to add Python to your PATH.
- Click Install Now.
- After the installation has completed, restart your machine.
- Verify that the Python binary is installed in your
PATH:> where python
C:\Users\<USER>\AppData\Local\Programs\Python\Python39\python.exe
For Linux installations, avoid modifying your system Python. Datadog recommends installing Python 3.12 using pyenv or miniconda.
You have 2 options to install the ddev CLI.
Install using a GUI
- In your browser, download the
.pkg file: ddev-10.2.0.pkg - Run your downloaded file and follow the on-screen instructions.
- Restart your terminal.
- To verify that the
ddev command has been added to your PATH, run the following command to retrieve the ddev version:
- In your browser, download one of the following
.msi files: - Run your downloaded file and follow the on-screen instructions.
- Restart your terminal.
- To verify that the
ddev command has been added to your PATH, run the following command to retrieve the ddev version:
Install from the command line
- Download the file using the
curl command. The -L option allows for redirects, and the -o option specifies the file name to which the downloaded package is written. In this example, the file is written to ddev-10.2.0.pkg in the current directory.curl -L -o ddev-10.2.0.pkg https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0.pkg
- Run the standard macOS
installer program, specifying the downloaded .pkg file as the source. Use the -pkg parameter to specify the name of the package to install, and the -target / parameter for the drive in which to install the package. The files are installed to /usr/local/ddev, and an entry is created at /etc/paths.d/ddev that instructs shells to add the /usr/local/ddev directory to. You must include sudo on the command to grant write permissions to those folders.sudo installer -pkg ./ddev-10.2.0.pkg -target /
- Restart your terminal.
- To verify that the shell can find and run the
ddev command in your PATH, use the following command.
- Download and run the installer using the standard Windows
msiexec program, specifying one of the .msi files as the source. Use the /passive and /i parameters to request an unattended, normal installation.x64:msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0-x64.msi
x86:msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0-x86.msi
- Restart your terminal.
- To verify that the shell can find and run the
ddev command in your PATH, use the following command.
Install from a standalone binary
After downloading the archive corresponding to your platform and architecture, extract the binary to a directory that is on your PATH and rename the binary to ddev.
