Skip to main content

Documentation Index

Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Hybrid Setup

The hybrid setup gives you the best of both worlds: LangWatch manages the control plane (application, UI, evaluations, prompt management), while your sensitive data stays in your own infrastructure.

How It Works

What stays in your infrastructure

  • ClickHouse — All trace data, span payloads, evaluation results, and analytics. This is where your LLM inputs/outputs and sensitive content live.
  • S3-compatible object storage — Datasets, ClickHouse cold storage tiers, and backups.

What LangWatch Cloud manages

  • Application UI and API
  • Evaluation orchestration
  • Prompt management and versioning
  • Scenario testing and simulations
  • User management and access control

Benefits

  • Data ownership — Sensitive LLM interactions never leave your infrastructure. You can pull the plug at any time.
  • Compliance — Meet data residency requirements by deploying the data plane in your preferred region.
  • No operational overhead — LangWatch handles application updates, scaling, and maintenance of the control plane.
  • Full functionality — All LangWatch features work identically to the fully-hosted version.

Requirements

The data plane requires:
ComponentMinimumRecommended
ClickHouseSingle node, 2 vCPU, 4 GiB RAM3-node replicated cluster
S3 storageAny S3-compatible providerSame region as ClickHouse
ClickHouse can be deployed as:
  • A managed service (e.g., ClickHouse Cloud, Aiven, Altinity)
  • Self-hosted on your Kubernetes cluster using our clickhouse-serverless helm chart
  • Self-hosted on VMs

Getting Started

The hybrid setup requires coordination with our team to configure the secure connection between LangWatch Cloud and your data plane. To get started:
  1. Contact us at support@langwatch.ai or through your account manager
  2. Provision your data plane — We’ll help you set up ClickHouse and S3 in your infrastructure
  3. Configure the connection — We’ll establish a secure link (typically via VPC peering, PrivateLink, or VPN) between LangWatch Cloud and your data plane
  4. Verify — Run traces and confirm data flows correctly while staying in your infrastructure

Interested in hybrid setup?

Contact our team to discuss your requirements and get started with a hybrid deployment.