This stack runs the open-source Langfuse v3 topology: web, asynchronous worker, PostgreSQL, ClickHouse, Redis, and S3-compatible object storage. Only the web and media endpoints bind to loopback; databases remain isolated on the Compose network.
- Copy
.env.exampleto.envand replace every placeholder. GenerateLANGFUSE_ENCRYPTION_KEYwithopenssl rand -hex 32. - Validate with
docker compose --env-file .env -f docker-compose.langfuse.yml config. - Start with
docker compose --env-file .env -f docker-compose.langfuse.yml up -d. - Verify
http://localhost:3100/api/public/healthand provision SDK keys through the initialization variables or the Langfuse UI.
Persist and back up all five named volumes. Pin image digests during production promotion and expose the loopback ports only through the authenticated Oshun ingress. Langfuse traces can contain prompts, retrieved context, and user data; apply the same retention, access-control, and redaction policy as production AI decision logs.