How do I install Dynatrace OneAgent?

To install Dynatrace OneAgent go to and Login using the username and password you received from Dynatrace in your signup confirmation email. The basic installation steps are simple. Still, we'll guide you each step of the way.

Before you begin

What you need

  • Your Dynatrace password for login.
  • Administrator credentials for the servers where Dynatrace OneAgent will be installed.
  • Administrator rights for changing firewall settings (necessary only if your internal routing policy may prevent Dynatrace software from reaching the Internet).
  • Permissions and credentials required for restarting all your application services.


All hosts that are to be monitored require full Internet access.

Step 1: Download the installer

  1. Select Deploy Dynatrace from the navigation menu.

  2. Click the Start installation button.

  3. Select one of the following installation options:

You have two options:

  • Windows installer (EXE file) for single-server installation. This is the most commonly used file for Windows deployments. Click the Windows button. Then click the Download agent.exe button on the following page.

  • Windows installer for Group Policy deployments. You get a ZIP package that includes an MSI file and an example command line in the form of a batch file (you can copy and paste the command line when configuring Group Policy for Dynatrace installation). For the group policy option, click the Windows button. On the following page, click the Download MSI package link in the footer.

Step 2: Install OneAgent

Run the executable file and follow the displayed instructions. You will need administrator rights to install OneAgent.

During installation, either enable or disable the following two settings:


On Windows, Dynatrace OneAgent runs as a system process.

During the installation process, the installer

  • Checks the system’s global proxy settings. If your system has global proxy settings, OneAgent will discover them and prompt you for permission to use them. If a proxy is required for an Internet connection, but it’s not configured in the system’s global proxy settings, then you must configure the proxy.

  • Checks for a connection to Dynatrace Server or Security Gateway (if you installed Security Gateway and downloaded the OneAgent installer after Security Gateway was connected to Dynatrace).


It’s recommended that you install the version of WinPcap that is packaged with the Dynatrace OneAgent installer. Its library is the cornerstone of Dynatrace network analysis. We’ve packaged the library in such a way that its DLLs are seamlessly integrated with Dynatrace software, thereby enabling unattended updates and other advantages. If you already have WinPcap installed, please remove it before Dynatrace OneAgent installation. The installer includes the latest, unmodified version of the library&so any other software you have that relies on WinPcap won’t suffer from library loss.

Step 3: Restart your server processes

While still logged into the systems where your server processes run, you need to restart each process so that its command line can be modified. The processes that require restart are listed for you during setup.

To restart your server processes, you’ll need to restart your web or application server. If your server is operating in a production environment, you may want to hold off on restart until the next scheduled maintenance period.


When you visit certain Host pages, Dynatrace may display a message telling you that you must restart the related host processes. Restart these processes to enable Dynatrace analysis of these hosts.

You can always check which process types Dynatrace supports.

You‘ve arrived!

Great, the first stage of Dynatrace setup is complete! Now take a look around your new home dashboard. You can access your new Dynatrace home dashboard anytime by going to Dynatrace website and clicking the Login button in the upper-right corner.