Docker Deployment

Docker Deployment

Deploy Optima Forge locally using Docker Compose. This setup runs all 15 sidecar services alongside the Forge application.

Prerequisites

• Docker Engine 24+
• Docker Compose v2+
• At least 16GB RAM available
• 50GB disk space

Quick Start

# Clone the repository
git clone https://github.com/optima-forge/forge.git
cd forge

# Copy environment template
cp .env.example .env

# Edit .env with your API keys
nano .env

# Start all services
docker compose up -d

# Check status
docker compose ps

Service Profiles

Docker Compose uses profiles to manage optional services. Start only what you need:

# Core services only (Redis, NATS, database)
docker compose --profile core up -d

# Core + memory (adds Qdrant, Neo4j)
docker compose --profile core --profile memory up -d

# Core + security (adds Presidio, LLM Guard, SpiceDB, OPA)
docker compose --profile core --profile security up -d

# Everything
docker compose --profile all up -d

Ports

Health Check

curl http://localhost:3402/health
# {"status":"ok","timestamp":1709000000}