Install agents

This page provides a generic description of Agent installation.

An Agent is a shared library that needs to be injected into the application process. For most Agents there is a bootstrap part that takes care of versioning.

The Agents installation packages include most of the Agents, so you don't have to install each Agent separately. See OS-related sections below for more details. The Node.js Agent, however, requires special handling. See Configure Node.js Agent for more information.

Installation directory

Documentation typically refers to the AppMon installation directory as DT_HOME (or <DT_HOME>).

The defaults for DT_HOME are:

  • Windows
    • C:\ProgramFiles\Dynatrace\Dynatrace <major.minorVersion> for a full installation.
    • C:\ProgramFiles\Dynatrace\Dynatrace Agent <major.minorVersion> for an Angent-only installation.
  • *NIX
    • /opt/dynatrace-<major.minorVersion> for a full installation
    • /opt/dynatrace-agent-<major.minorVersion> for an Agent-only installation
      To use these default directories you need to run the cd /opt command before installation as recommended below.

With a *NIX shell script or .tar, you need to create a directory by entering md then enter cd to go the desired directory before running/unpacking it.

The actual bootstrap and core Agent parts are installed to DT_HOME/agent/lib[64] and updates to the core are in DT_HOME/agent/downloads/<version>. Shared memory and .ini files are in DT_HOME/agent/confDT_HOME/log is common to all components, which is one reason that it is important to keep the DT_HOME folder structure and permissions.


Download the Agent Windows installation package of choice for your architecture (32 or 64-bit) and run it. You may need to run for a custom installation and manually selected Agents to be installed.

The Windows full install package and Agents-only install package include all the Agents, except for Node.js. For instructions on installation Node.js Agent, see Configure Node.js Agent.


Download the appropriate AppMon installation package (.jar or .tar file) for your architecture (x86, x64, PPC) and instrumentation needs.

JRE version

The .jar-based Agent installer requires a JRE 1.8 or later. Some Agent installers come as .tar shell scripts and do not require a JRE, as the .sh has the Agents embedded. The .jar file asks for the install directory, but the .sh does not. Both default to the current directory.

The Agent-only installation package, despite being .jar-based, works with JRE 1.6 or later.

Full installation package

The *NIX full installation package include all the Agents, except for Node.js Agent. It comes for 64-bit architecture only.

Use the following to install it:

cd /opt
sudo java -jar <pathToJar>/dynatrace-full-<version>-linux-x86-64.jar

Agent-only installation package

The Agent-only installation package doesn't have Node.js Agent, Host Monitoring Agent, and Web Server Agents — Web Server Master, NGINX, and PHP Agents. You should download and install them separately. For instructions on installation Node.js Agent, see Configure Node.js Agent.

The Agents installation package comes as .jar file. Install it as follows:

cd /opt
sudo java -jar <pathToJar>/dynatrace-agent-<version>-unix.jar

Web Server Agents installation package

The Web Server Agents package comes as .tar file, containing .sh shell script. Use these commands to install it:

cd /opt
tar -xvf <pathToTar>/dynatrace-wsagent-<version>-<os>-<architecture>.tar
cd /<DT_HOME>

Host Agents installation package

The Host Agents package comes as .tar file, containing all Agent files. You just need to extract it — no additional installation needed:

cd /opt
tar -xvf <pathToTar>/dynatrace-hostagent-<version>-<os>-<architecture>.tar

AppMon Agent

With AppMon 2017 May you need to install Classic Agents first, and then roll them out to switch the agent platform.

Automation Downloads

Details on Downloads for automated agent integration.

Automatic installation

You can automate the installation with Ansible, Chef, or Puppet. Click the link below for more detailed information.