---
title: "PHP APM with Docker"
slug: "php-apm-with-docker"
description: "Learn how to install PHP APM Profiler on Docker or Docker Swarm for PHP applications. Follow the guide and verify results in Retrace dashboard. "
updated: 2019-05-20T21:05:23Z
published: 2019-05-20T21:05:23Z
canonical: "docs.stackify.com/php-apm-with-docker"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PHP APM with Docker

This document details how to install the **PHP APM Profiler** in your **PHP** application running on **Docker** or **Docker Swarm**.

## Prerequisite

Follow the [Retrace Docker Install](https://docs.stackify.com/docs/retrace-docker-install) Guide.

## PHP Docker Setup

#### Dockerfile Configuration

Adjust your **Dockerfile** to include the PHP Profiler:

```
RUN mkdir -p /stackify-php-apm && \
    cd /stackify-php-apm && \
    wget https://download.stackify.com/stackify-php-apm/stackify-php-apm-latest.tar.gz;  tar -zxvf stackify-php-apm-latest.tar.gz; rm stackify-php-apm-latest.tar.gz && \
    ./install.sh

RUN echo "[stackify]" >> [php_dir]/php.ini && \
   echo "extension=stackify.so" >> [php_dir]/php.ini && \
   echo "stackify.application_name=PHP Application" >>  [php_dir]/php.ini && \
   echo "stackify.environment_name=Production" >>  [php_dir]/php.ini
```

Adjust `[php_dir]` to point to your PHP configuration path.

## Running your Application

Start your application with the `stackify` shared volume.

```
docker run -v stackify:/usr/local/stackify [your-application-image]
```

## Verify

Start up your PHP application container and make requests. You can then verify results in the Retrace dashboard.

## Additional Guides

- [Troubleshooting](https://docs.stackify.com/docs/php-apm-troubleshooting-guide)
- [Log / Deployment Tracking](https://docs.stackify.com/docs/php-getting-started)