Skip to content

Installation


Package managers

Homebrew

Install the dda cask using Homebrew.

brew install --cask dda

You can upgrade to the latest version by running the following command.

brew upgrade --cask dda

Installers

  1. In your browser, download the .pkg file: dda-universal.pkg
  2. Run your downloaded file and follow the on-screen instructions.
  3. Restart your terminal.
  4. To verify that the shell can find and run the dda command in your PATH, use the following command.
    $ dda --version
    0.25.0
    
  1. Download the file using the curl command. The -o option specifies the file name that the downloaded package is written to. In this example, the file is written to dda-universal.pkg in the current directory.
    curl -Lo dda-universal.pkg https://github.com/DataDog/datadog-agent-dev/releases/latest/download/dda-universal.pkg
    
  2. 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/dda, and an entry is created at /etc/paths.d/dda that instructs shells to add the /usr/local/dda directory to. You must include sudo on the command to grant write permissions to those folders.
    sudo installer -pkg ./dda-universal.pkg -target /
    
  3. Restart your terminal.
  4. To verify that the shell can find and run the dda command in your PATH, use the following command.
    $ dda --version
    0.25.0
    
  1. In your browser, download one the .msi files:
  2. Run your downloaded file and follow the on-screen instructions.
  3. Restart your terminal.
  4. To verify that the shell can find and run the dda command in your PATH, use the following command.
    $ dda --version
    0.25.0
    
  1. 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.

    msiexec /passive /i https://github.com/DataDog/datadog-agent-dev/releases/latest/download/dda-x64.msi
    
    msiexec /passive /i https://github.com/DataDog/datadog-agent-dev/releases/latest/download/dda-x86.msi
    
  2. Restart your terminal.

  3. To verify that the shell can find and run the dda command in your PATH, use the following command.
    $ dda --version
    0.25.0
    

Standalone binaries

After downloading the archive corresponding to your platform and architecture, extract the binary to a directory that is on your PATH and rename to dda.

Upgrade

You can upgrade to the latest version by running the following command.

dda self update

If you installed dda using a package manager, prefer its native upgrade mechanism.

Warning

Development and manual installations do not support this command and each have their own means of upgrading.

Development

You can install dda directly from the source code, outside of release cycles. This is useful if you want to test the latest changes or contribute to the project.

  1. Clone the dda repository and enter the directory.

    git clone https://github.com/DataDog/datadog-agent-dev.git
    cd datadog-agent-dev
    
  2. Install UV.

  3. Run the following command to install dda as a tool in development mode:

    uv tool install -e .
    
  4. (optional) If installation emitted a warning about a directory not being on your PATH, you can add it manually or run the following command to add it automatically.

    uv tool update-shell
    

This will ensure that dda always uses the version of the code checked out in the repository. However, this will not automatically reflect changes in dependencies. To synchronize those as well at any point after installation, run the following command.

uv tool upgrade dda

Manual

Warning

This method is not recommended.

dda is available on PyPI and can be installed with any Python package installer like pip or UV.

The Python environment in which you choose to install must be at least version 3.12.