These guides support organizations that already operate a self-hosted data plane. For new organizations looking to keep data in your own cloud, see Bring your own cloud (BYOC).
Version requirements
Features not listed here work on every supported data plane version.Observe
Evaluate
Datasets
Loop
Loop features also require the Loop runtime. See Feature support by cloud.Topics and Patterns
Patterns also requires the Loop runtime. Topics requires built-in models, which are off by default on self-hosted deployments. See Enable Topics.
Project pattern alert destinations ship with Helm chart 6.31.0.
SQL
Admin and security
Integrations and MCP
Gateway
Feature support by cloud
Some features depend on infrastructure that only some clouds provide, and some aren’t available on self-hosted deployments at all.See also
Releases and availability- Self-hosting releases: Review release notes and the minimum Terraform or Helm version for each data plane version.
- Feature availability: Find the data plane version each feature requires and which features each cloud supports.
- Architecture: Understand the control plane, data plane, and where data is stored.
- Deploy Braintrust: Deploy the data plane on AWS, GCP, or Azure.
- CloudFormation: Manage a legacy AWS CloudFormation deployment.
- Configure your deployment: Review the settings available after deployment.
- Security and access: Restrict organization access, secure customer data, and harden pods.
- Networking and connectivity: Configure URLs, rate limits, load balancers, and network access paths.
- Scaling and storage: Size API and Brainstore compute.
- Self-host the Braintrust Gateway: Deploy the Gateway in your data plane.
- Loop runtime: Run Loop threads in isolated sandboxes on AWS or GCP.
- Telemetry and data retention: Control telemetry and enable data retention.
- Upgrade your deployment: Follow the routine upgrade process.
- Upgrade to data plane v2.x: Migrate to the data plane v2 series.
- Upgrade to Terraform module v6: Move AWS API traffic from Lambda to ECS.
- Upgrade to Terraform module v7: Route AWS API traffic to ECS and deploy the Gateway by default.