Step 1: Installedit

This method of installing APM Server will be deprecated and removed in a future release. Please consider getting started with the Elastic APM integration instead.

Before you begin: If you haven’t installed the Elastic Stack, do that now. See Learn how to install the Elastic Stack on your own hardware.

To download and install APM Server, use the commands below that work with your system. If you use apt or yum, you can install APM Server from our repositories to update to the newest version more easily.

See our download page for other installation options, such as 32-bit images.

deb:

curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-8.3.3-amd64.deb
sudo dpkg -i apm-server-8.3.3-amd64.deb

RPM:

curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-8.3.3-x86_64.rpm
sudo rpm -vi apm-server-8.3.3-x86_64.rpm

Other Linux:

curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-8.3.3-linux-x86_64.tar.gz
tar xzvf apm-server-8.3.3-linux-x86_64.tar.gz

Mac:

curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-8.3.3-darwin-x86_64.tar.gz
tar xzvf apm-server-8.3.3-darwin-x86_64.tar.gz

Windows:

  1. Download the APM Server Windows zip file from the downloads page.
  2. Extract the contents of the zip file into C:\Program Files.
  3. Rename the apm-server-<version>-windows directory to APM-Server.
  4. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select Run As Administrator). If you are running Windows XP, you may need to download and install PowerShell.
  5. From the PowerShell prompt, run the following commands to install APM Server as a Windows service:

    PS > cd 'C:\Program Files\APM-Server'
    PS C:\Program Files\APM-Server> .\install-service-apm-server.ps1

If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-apm-server.ps1.

Docker:

See Running on Docker for deploying Docker containers.