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

# Docker

> Install Tracer within your Docker under two minutes

<Accordion title="Recommended System Requirements">
  For optimal Docker performance, we recommend a system with at least **4 CPU cores** and **8GB RAM**, running Docker Desktop or Docker Engine on Linux Ubuntu 22.04 or higher.
</Accordion>

## Prerequisites

Make sure you have Docker installed on your system. If not, please install it first:

<CardGroup cols={2}>
  <Card href="https://docs.docker.com/desktop/install/mac-install/">
    <img src="https://mintcdn.com/tracer/gt5rP50myLglkNqU/images/other_logos/Apple-Black.png?fit=max&auto=format&n=gt5rP50myLglkNqU&q=85&s=e5397efc98095acaf0e8c4b9bb42a43c" className="block dark:hidden" alt="Apple" style={{ width: '50px', marginBottom: '10px' }} width="200" height="200" data-path="images/other_logos/Apple-Black.png" />

    <img src="https://mintcdn.com/tracer/gt5rP50myLglkNqU/images/other_logos/Apple-Black.png?fit=max&auto=format&n=gt5rP50myLglkNqU&q=85&s=e5397efc98095acaf0e8c4b9bb42a43c" className="hidden dark:block" alt="Apple" style={{ width: '50px', marginBottom: '10px' }} width="200" height="200" data-path="images/other_logos/Apple-Black.png" />

    **Docker Desktop for Mac**<br />
    Install Docker Desktop on macOS
  </Card>

  <Card href="https://docs.docker.com/engine/install/ubuntu/">
    <img src="https://mintcdn.com/tracer/gt5rP50myLglkNqU/images/other_logos/Ubuntu-Black.png?fit=max&auto=format&n=gt5rP50myLglkNqU&q=85&s=eb95dee25d1e9995e64e0605afd7a7b3" className="block dark:hidden" alt="Ubuntu" style={{ width: '50px', marginBottom: '10px' }} width="200" height="200" data-path="images/other_logos/Ubuntu-Black.png" />

    <img src="https://mintcdn.com/tracer/gt5rP50myLglkNqU/images/other_logos/Ubuntu-Black.png?fit=max&auto=format&n=gt5rP50myLglkNqU&q=85&s=eb95dee25d1e9995e64e0605afd7a7b3" className="hidden dark:block" alt="Ubuntu" style={{ width: '50px', marginBottom: '10px' }} width="200" height="200" data-path="images/other_logos/Ubuntu-Black.png" />

    **Docker Engine for Ubuntu**<br />
    Install Docker Engine on Ubuntu
  </Card>
</CardGroup>

## 1. Pull the Tracer Docker image

Run the following command to pull the latest Tracer Docker image:

```bash theme={null}
docker pull tracercloud/tracer:latest
```

## 2. Run the Tracer container

Start a Tracer container with the following command:

```bash theme={null}
docker run -d --rm \
  --name tracer \
  --privileged \
  --pid=host \
  -p 8080:8080 \
  -v /lib/modules:/lib/modules:ro \
  -v /usr/src:/usr/src:ro \
  -v /sys/kernel/debug:/sys/kernel/debug:rw \
  -v /sys/kernel/btf/vmlinux:/sys/kernel/btf/vmlinux:ro \
  tracercloud/tracer:latest
```

## 3. Access Tracer

<Card href="https://app.tracer.cloud/">
  <img className="block dark:hidden" src="https://mintcdn.com/tracer/lwvLzCSZlgrNXB_D/images/logo/tracer/Tracer%20Full%20Body%20-%20Black.png?fit=max&auto=format&n=lwvLzCSZlgrNXB_D&q=85&s=3ba40411baa608f2cf09ea4372ad16b2" alt="Tracer Logo" style={{ width: '10%', height: 'auto', marginBottom: '1rem' }} width="311" height="84" data-path="images/logo/tracer/Tracer Full Body - Black.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/tracer/lwvLzCSZlgrNXB_D/images/logo/tracer/Tracer%20Full%20Body%20-%20Black.png?fit=max&auto=format&n=lwvLzCSZlgrNXB_D&q=85&s=3ba40411baa608f2cf09ea4372ad16b2" alt="Tracer Logo" style={{ width: '10%', height: 'auto', marginBottom: '1rem' }} width="311" height="84" data-path="images/logo/tracer/Tracer Full Body - Black.png" />

  <div style={{ fontSize: '1.3rem', fontWeight: '700', marginBottom: '1rem', color: 'inherit' }}>
    Once the container is running, you can access Tracer
  </div>

  <div style={{ color: 'inherit' }}>
    View real-time metrics, resource usage, and performance insights for your pipeline runs.
  </div>
</Card>
