Upgrade to Datadog Agent 7

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!
Agent 7 only supports Python 3 custom checks. Check if your custom checks are Python 3 compatible before upgrading to Agent 7.

From Agent 6

Run the following Agent installation command to upgrade your Agent from version 6 to version 7:

The following command works on Amazon Linux, CentOS, Debian, Fedora, Red Hat, Ubuntu, and SUSE:
DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
  1. Download the Datadog Agent installer.
  2. Run the installer (as Administrator) by opening datadog-agent-7-latest.amd64.msi.
  3. Follow the prompts, accept the license agreement, and enter your Datadog API key.
  4. When the install finishes, you are given the option to launch the Datadog Agent Manager.

Note: Links to all available versions of the Windows Installer are provided in JSON format.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 to upgrade your Agent from version 6 to version 7:

DD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_mac_os.sh)"

From Agent 5

Run the Agent installation command with the environment variable DD_UPGRADE="true" to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

The following command works on Amazon Linux, CentOS, Debian, Fedora, Red Hat, Ubuntu, and SUSE:
DD_UPGRADE="true" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
  1. Upgrade your Agent to version 6 following the manual upgrade process.
  2. Follow the From Agent v6 to Agent v7 upgrade instructions.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 and DD_UPGRADE="true" to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

DD_UPGRADE="true" DD_AGENT_MAJOR_VERSION=7 bash -c "$(curl -L https://install.datadoghq.com/scripts/install_mac_os.sh)"

Note: The upgrade process won’t automatically move custom Agent checks. This is by design as Datadog cannot guarantee full backwards compatibility out of the box. See the Python 3 Custom Check Migration guide to discover how to migrate your custom check from Python 2 to Python 3.

Further Reading

Additional helpful documentation, links, and articles: