Step 1: Installedit

Before you begin: If you haven’t installed the Elastic Stack, do that now. See Getting started with the Elastic Stack.

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-7.2.1-amd64.deb
sudo dpkg -i apm-server-7.2.1-amd64.deb

RPM:

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

Other Linux:

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

Mac:

curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-7.2.1-darwin-x86_64.tar.gz
tar xzvf apm-server-7.2.1-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.

Homebrew:

You can install the Elastic Stack, including APM Server, on macOS with the Homebrew package manager. First, tap the Elastic Homebrew repository:

brew tap elastic/tap

Next, use brew install to install the default distribution of APM Server:

brew install elastic/tap/apm-server-full

This installs the most recently released default distribution of APM Server. To install the OSS distribution, specify elastic/tap/apm-server-oss.

Docker:

See Running on Docker for deploying Docker containers.