Helm

This guide walks you through deploying Activepieces on Kubernetes using the official Helm chart.

​

Prerequisites

• Kubernetes cluster (v1.19+)
• Helm 3.x installed
• kubectl configured to access your cluster

​

Quick Start

​

1. Clone the Repository

git clone https://github.com/activepieces/activepieces.git
cd activepieces

​

2. Install Dependencies

helm dependency update

​

3. Create a Values File

Create a my-values.yaml file with your configuration. You can use the example values file as a reference.

​

4. Install Activepieces

helm install activepieces deploy/activepieces-helm -f my-values.yaml

​

5. Verify Installation

# Check deployment status
kubectl get pods
kubectl get services

​

Production Checklist

• Set strong passwords for PostgreSQL and Redis
• Configure proper ingress with TLS
• Set appropriate resource limits
• Configure persistent storage
• Review environment variables for proper configuration
• Choose appropriate execution mode for your security requirements
• Consider using a separate workers setup for better availability and security

​

Upgrading

# Update dependencies
helm dependency update

# Upgrade release
helm upgrade activepieces deploy/activepieces-helm -f my-values.yaml

# Check upgrade status
kubectl rollout status deployment/activepieces

​

Troubleshooting

​

Common Issues

1. Pod won’t start: Check logs with kubectl logs deployment/activepieces
2. Database connection: Verify PostgreSQL credentials and connectivity
3. Frontend URL: Ensure frontendUrl is accessible from external sources
4. Webhooks not working: Check ingress configuration and DNS resolution

​

Useful Commands

# View logs
kubectl logs deployment/activepieces -f

# Port forward for testing
kubectl port-forward svc/activepieces 4200:80 --namespace default

# Get all resources
kubectl get all --namespace default

​

Environment Variables

For a complete list of configuration options, see the Environment Variables documentation. Most environment variables can be configured through the Helm values file under the activepieces section.

​

Execution Modes

Understanding execution modes is crucial for security and performance. See the Workers & Sandboxing guide to choose the right mode for your deployment.

​

Uninstalling

helm uninstall activepieces

# Clean up persistent volumes (optional)
kubectl delete pvc -l app.kubernetes.io/instance=activepieces