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

# Docker Compose Deployment

> Deploy Lumina with Docker Compose

Production-ready Docker Compose deployment.

***

## Prerequisites

* Docker 20.10+
* Docker Compose 2.0+
* 4GB RAM minimum
* 50GB disk space

***

## Installation

```bash theme={null}
git clone https://github.com/use-lumina/Lumina.git
cd Lumina/infra/docker
docker compose up -d
```

***

## Configuration

Edit `.env`:

```bash theme={null}
# Database
POSTGRES_PASSWORD=<strong-password>

# Retention
TRACE_RETENTION_DAYS=30
DAILY_TRACE_LIMIT=100000

# API Keys (optional)
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
```

***

## Scaling

Scale services:

```bash theme={null}
docker compose up -d --scale ingestion=3 --scale worker=5
```

***

## Monitoring

View logs:

```bash theme={null}
docker compose logs -f
```

Check health:

```bash theme={null}
docker compose ps
```
