Skip to main content
LangWatch is distributed as three Docker images, each serving a distinct role in the platform.

Images

langwatch/langwatch

The main application image. Used for both LangWatch App and LangWatch Workers. Handles the web UI, REST API, OTel trace ingestion, and authentication. What it does:
  • Serves the LangWatch web UI (Next.js)
  • Exposes REST and OTel APIs for trace ingestion from SDKs
  • Handles authentication (NextAuth.js with email or SSO providers)
  • Queries ClickHouse for analytics, dashboards, and trace search
  • Manages the control plane via PostgreSQL (Prisma ORM)
  • Broadcasts real-time updates via Server-Sent Events (SSE)

langwatch/langwatch_nlp

Python service for natural language processing tasks. What it does:
  • Runs Optimization Studio workflows
  • Executes topic clustering algorithms
  • Handles custom evaluator execution
  • Processes NLP tasks (embeddings, text analysis)

langwatch/langevals

Python service providing the built-in evaluator library. What it does:
  • LLM-as-a-Judge evaluators (boolean, category, score)
  • RAG evaluators (faithfulness, context precision, context recall, answer relevancy)
  • Safety evaluators (content safety, jailbreak detection, PII detection)
  • Quality evaluators (summarization, query resolution, semantic similarity)
  • Custom evaluators (exact match, BLEU/ROUGE scores, format validation)
LangEvals calls external LLM providers (OpenAI, Azure OpenAI, Google) to run model-based evaluations. Ensure your evaluator pods have network access to these providers, or configure your own provider credentials via the Helm chart.

Additional Images

The Helm chart also deploys:
  • langwatch/clickhouse-serverless, Performance-tweaked ClickHouse image optimized for LangWatch’s event ingestion and analytical query patterns

Service Communication

Image Tags

Pin to a specific version tag in production to prevent unexpected changes during upgrades. Update deliberately using the Upgrade Guide.

Private Registries

For air-gapped or private environments, mirror the images to your own registry:
Then configure the Helm chart: