Official Helm charts for deploying Formbricks Hub on Kubernetes.
This repository contains Helm charts for Formbricks Hub, a unified experience data platform with AI enrichment capabilities. The charts are designed to be production-ready with support for high availability, autoscaling, and multiple database deployment options.
- Kubernetes 1.24+
- Helm 3.10+
helm install hub oci://ghcr.io/formbricks/charts/hub --version 0.1.0For detailed installation instructions and configuration options, see the chart README.
The main Formbricks Hub application chart.
Features:
- CloudNativePG integration for PostgreSQL (optional)
- External database support (AWS RDS, Google Cloud SQL, Azure Database, etc.)
- OpenAI integration with multiple secret management options
- Horizontal Pod Autoscaler for dynamic scaling
- Ingress configuration with TLS support
- ServiceMonitor for Prometheus integration
- External Secrets Operator integration
- Production-ready security configurations
Installation:
helm install hub oci://ghcr.io/formbricks/charts/hubDocumentation: charts/hub/README.md
hub-helm/
├── charts/
│ └── hub/ # Hub application chart
│ ├── Chart.yaml # Chart metadata
│ ├── values.yaml # Default configuration
│ ├── README.md # Chart documentation
│ ├── templates/ # Kubernetes manifests
│ ├── examples/ # Example configurations
│ └── ci/ # CI test values
├── .github/
│ └── workflows/ # CI/CD workflows
└── README.md # This file
- Clone the repository:
git clone https://github.com/formbricks/hub-helm.git
cd hub-helm- Lint the chart:
helm lint charts/hub- Template the chart:
helm template test charts/hub --values examples/minimal-values.yaml- Test installation on a local cluster (kind/minikube):
# Create kind cluster
kind create cluster --name hub-test
# Install CloudNativePG operator
kubectl apply --server-side -f \
https://raw.githubusercontent.com/cloudnative-pg/cloudnative-pg/release-1.25/releases/cnpg-1.25.0.yaml
# Install chart
helm install hub charts/hub --values charts/hub/ci/ci-values.yamlWe welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Test locally using the steps above
- Submit a pull request
All pull requests are automatically validated using chart-testing and kind clusters.
This repository follows Semantic Versioning:
- Major version: Breaking changes to chart values or behavior
- Minor version: New features, backward compatible
- Patch version: Bug fixes, no API changes
The chart version is independent from the Hub application version, which is tracked in Chart.yaml as appVersion.
Releases are automated via GitHub Actions:
- Create and push a tag:
git tag -a v0.1.0 -m "Release version 0.1.0"
git push origin v0.1.0- GitHub Actions automatically:
- Updates Chart.yaml with the release version
- Packages the Helm chart
- Publishes to GitHub Container Registry (ghcr.io)
- Creates a GitHub release with auto-generated changelog
- Attaches the chart package to the release
Charts are published to GitHub Container Registry and available via OCI:
# Pull specific version
helm pull oci://ghcr.io/formbricks/charts/hub --version 0.1.0
# Install specific version
helm install hub oci://ghcr.io/formbricks/charts/hub --version 0.1.0The chart is listed on Artifact Hub for easy discovery.
- Application Issues: formbricks/hub
- Chart Issues: formbricks/hub-helm
- Website: formbricks.com
- Email: hola@formbricks.com
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- Built with CloudNativePG for PostgreSQL management
- Uses External Secrets Operator for secret management
- Integrates with Prometheus Operator for monitoring