This document runs thought how to get LangWatch up and running quickly, using our pre-configured Helm chart.
While the open-source version is available for local use and experimentation, for commercial use please reach out for a demo call with our team.

Required Values

When installing this chart, the following environment variables must be provided:
  • app.env.NEXTAUTH_SECRET: A random string used to hash tokens, sign cookies, and generate cryptographic keys. Required for authentication to work.
  • app.env.API_TOKEN_JWT_SECRET: A random string used to securely store API tokens.
  • app.env.CRON_API_KEY: A random string used to authenticate with the cron service for triggers and other background jobs.
  • app.env.BASE_HOST: The base URL of the application (e.g., https://langwatch.yourdomain.com or http://localhost:5560 on e.g. minikube or port-forwarding).
  • app.env.NEXTAUTH_URL: The URL of the authentication service (usually same as BASE_HOST).

Example Setup

The Helm Chart includes a non-managed OpenSearch pod that is not optimized for production workloads. This deployment is suitable for testing and evaluation purposes. For production deployments with high availability and performance requirements, please contact our team to discuss your specific infrastructure needs.
# Generate secure secrets
export NEXTAUTH_SECRET=$(openssl rand -base64 32)
export API_TOKEN_JWT_SECRET=$(openssl rand -base64 32)
export CRON_API_KEY=$(openssl rand -base64 32)
export METRICS_API_KEY=$(openssl rand -base64 32)

# Set application URLs
export BASE_HOST="http://localhost:5560" # for minikube or port-forwarding, or "https://langwatch.yourdomain.com" for the definitive deployment
export NEXTAUTH_URL="http://localhost:5560" # for minikube or port-forwarding, or "https://langwatch.yourdomain.com" for the definitive deployment

# Add LangWatch Helm repository
helm repo add langwatch https://langwatch.github.io/langwatch/
helm repo update

# Install the chart
helm install langwatch langwatch/langwatch-helm \
  --set app.env.NEXTAUTH_SECRET=$NEXTAUTH_SECRET \
  --set app.env.API_TOKEN_JWT_SECRET=$API_TOKEN_JWT_SECRET \
  --set app.env.BASE_HOST=$BASE_HOST \
  --set app.env.NEXTAUTH_URL=$NEXTAUTH_URL \
  --set app.env.CRON_API_KEY=$CRON_API_KEY
  --set app.env.METRICS_API_KEY=$METRICS_API_KEY \
  --set global.monitoring.enabled=true \
  --set prometheus.enabled=true

Port Forwarding

Once the chart is installed, you can port-forward the service to open up in your local browser before setting up the proper domain.
kubectl port-forward service/langwatch-app 5560:5560
Then you can access the application at http://localhost:5560.