wexa-studio-helm

Wexa Studio Helm Charts

Official Helm charts for deploying Wexa Studio - an enterprise-grade Agentic SaaS platform for AI-powered workflows and automation.

Charts

Chart	Description	Version
wexa-studio	Complete Wexa platform deployment	1.2.0

Prerequisites

• Kubernetes 1.23+
• Helm 3.8+
• PV provisioner support in the cluster

Required CRDs

Before installing, install the MongoDB Community Operator CRDs:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes-operator/master/config/crd/bases/mongodbcommunity.mongodb.com_mongodbcommunity.yaml

Quick Start

Add the Helm Repository

helm repo add wexa https://wexahq.github.io/wexa-studio-helm
helm repo update

Search Available Charts

helm search repo wexa

Install the Chart

# Create namespace
kubectl create namespace wexa

# Install with default values
helm install wexa-studio wexa/wexa-studio -n wexa

# Or install with custom values
helm install wexa-studio wexa/wexa-studio -n wexa -f values.yaml

Configuration

See the wexa-studio chart documentation for detailed configuration options.

Minimal Production Configuration

# production-values.yaml
global:
  storageClass: "your-storage-class"

mongodb:
  auth:
    rootPassword: "your-secure-password"

redis:
  auth:
    password: "your-secure-password"

vault:
  auth:
    rootToken: "your-vault-token"

postgresql:
  auth:
    password: "your-secure-password"

ghcrSecret:
  dockerConfigJson: "your-base64-encoded-docker-config"

helm install wexa-studio wexa/wexa-studio -n wexa -f production-values.yaml

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Wexa Platform                           │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │  Wexa Web   │  │  Identity   │  │     Data Service        │  │
│  │  (Frontend) │  │  Service    │  │  (API + Migrations)     │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
│         │                │                      │               │
│         └────────────────┼──────────────────────┘               │
│                          │                                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │   Worker    │  │  Schedule   │  │   LLM Calls Service     │  │
│  │             │  │   Worker    │  │                         │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
├─────────────────────────────────────────────────────────────────┤
│                      Infrastructure                             │
│  ┌───────┐ ┌───────┐ ┌────────┐ ┌───────┐ ┌───────┐ ┌───────┐  │
│  │MongoDB│ │ Redis │ │Temporal│ │ Vault │ │ MinIO │ │Qdrant │  │
│  │(3node)│ │       │ │        │ │       │ │       │ │       │  │
│  └───────┘ └───────┘ └────────┘ └───────┘ └───────┘ └───────┘  │
│                           │                                     │
│                 ┌─────────────────┐                             │
│                 │   PostgreSQL    │                             │
│                 │  (for Temporal) │                             │
│                 └─────────────────┘                             │
└─────────────────────────────────────────────────────────────────┘

Components

The Wexa Helm chart deploys the following components:

Application Services

• Data Service - Core API and data processing
• Identity Service - Authentication and authorization
• Worker - Background job processing
• Schedule Worker - Scheduled task execution
• LLM Calls Service - LLM integration service
• Wexa Web - Frontend application

Infrastructure

• MongoDB - Primary database (3-node replica set)
• Redis - Caching and session storage
• PostgreSQL - Temporal workflow database
• Temporal - Workflow orchestration engine
• HashiCorp Vault - Secrets management
• MinIO - S3-compatible object storage
• Qdrant - Vector database for AI/ML workloads

Upgrading

helm repo update
helm upgrade wexa-studio wexa/wexa-studio -n wexa

Uninstalling

helm uninstall wexa-studio -n wexa

# Optional: Delete PVCs
kubectl delete pvc -l app.kubernetes.io/instance=wexa-studio -n wexa

# Optional: Delete namespace
kubectl delete namespace wexa

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development

# Clone the repository
git clone https://github.com/wexahq/wexa-studio-helm.git
cd wexa-studio-helm

# Lint charts
helm lint charts/wexa-studio

# Package charts
helm package charts/wexa-studio

# Test installation
helm install wexa-test charts/wexa-studio -n wexa-test --create-namespace --dry-run

Support

• 📖 Documentation: https://docs.wexa.ai
• 🐛 Issues: https://github.com/wexahq/wexa-studio-helm/issues
• 📧 Email: support@wexa.ai

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Security

For security issues, please email security@wexa.ai instead of using the issue tracker.

This site is open source. Improve this page.