---
title: "Docker Install"
slug: "retrace-docker-install"
description: "Easily install Retrace in Docker with this step-by-step guide. Monitor .NET Core, Java, PHP, Node.js, Ruby, Python apps & get APM insights."
updated: 2023-08-29T13:59:54Z
published: 2023-08-29T13:59:54Z
---

> ## 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.

# Docker Install

This document details how to install **Retrace** in a **Docker** environment.

## Create a Volume

The following volume allows for your application containers and the Stackify Retrace container to communicate.

```
docker volume create stackify
```

## Run Retrace Container

Run the Stackify Retrace container (ensure that this container is always running via `--restart always` or your own method).

```
docker pull stackify/retrace
docker run -d --restart always \
 -e "STACKIFY_KEY=YOUR_ACTIVATION_KEY" \
 -e "STACKIFY_ENV=YOUR_ENVIRONMENT_NAME" \
 -v stackify:/var/stackify \
 -v /:/hostfs:ro \
 --user 0:0 \
 stackify/retrace:latest
```

**Note:** Replace `YOUR_ACTIVATION_KEY` and `YOUR_ENVIRONMENT_NAME`. Use Image `stackify/retrace-arm64` if running on an ARM processor.

## Run Retrace Container via Compose

```
version: '3'
services:
  stackify:
    image: stackify/retrace:latest 
    environment:
     - STACKIFY_KEY=YOUR_ACTIVATION_KEY
     - STACKIFY_ENV=YOUR_ENVIRONMENT_NAME
    user: 0:0
    volumes:
     - stackify:/var/stackify
     - /:/hostfs:ro
volumes:
  stackify:
    external:
      name: stackify
```

**Note:** Replace `YOUR_ACTIVATION_KEY` and `YOUR_ENVIRONMENT_NAME`.

## Application Setup

The following guides detail how to configure your application containers for APM.

- [.Net Core](https://docs.stackify.com/docs/net-core-apm-with-docker-in-linux)
- [Java](https://docs.stackify.com/docs/java-apm-with-docker)
- [PHP](https://docs.stackify.com/docs/php-apm-with-docker)
- [Node.js](https://docs.stackify.com/docs/nodejs-apm-with-docker)
- [Ruby](https://docs.stackify.com/docs/ruby-apm-with-docker)
- [Python](https://docs.stackify.com/docs/python-apm-with-docker)

## Limitations

The following are known limitations of Retrace when using the Stackify Retrace container.

- Apache/Nginx/Syslog Log Collectors are disabled
- Auto Agent update is disabled
- Agent restarting via Retrace is disabled
- Server Service listing limited to SystemV (service status will be marked as `UNKNOWN`)
- JMX MBeans is disabled