Community

Helm Charts

This repository contains Helm charts for deploying Synapse and related components.

Charts

synapse

A Helm chart for Synapse reverse proxy with security features.

Dependencies:

• valkey - Redis-compatible in-memory data store
• clamav - Antivirus engine

synapse-operator

A Helm chart for the Synapse Kubernetes operator.

synapse-stack

Umbrella chart that installs both the Synapse dataplane and the Synapse Kubernetes operator together.

Dependencies:

• synapse - Synapse reverse proxy chart

ssl-storage

Helm chart for deploying the SSL Storage ACME/Let's Encrypt certificate management service.

Installation

Add the Helm repository

helm repo add arxignis https://helm.arxignis.com
helm repo update

Install synapse-stack (recommended)

Install both the Synapse dataplane and operator together:

helm install synapse-stack arxignis/synapse-stack --version 0.1.0

Install synapse only

Install just the Synapse reverse proxy:

helm install synapse arxignis/synapse --version 0.1.0

Install synapse-operator only

Install just the Synapse Kubernetes operator:

helm install synapse-operator arxignis/synapse-operator --version 1.0.6

Usage

See the individual chart directories for detailed configuration options:

• synapse chart values
• synapse-operator chart values
• synapse-stack chart values

Repository

Charts are automatically published to:

• Repository URL: https://helm.arxignis.com
• GitHub Repository: https://github.com/arxignis/helm-charts

Development

Releasing Charts

Charts are automatically released via separate GitHub Actions workflows when changes are pushed to the main branch:

• Synapse Chart: Changes to charts/synapse/** trigger the release-synapse.yaml workflow
• Synapse Operator Chart: Changes to charts/synapse-operator/** trigger the release-synapse-operator.yaml workflow
• Synapse Stack Chart: Changes to charts/synapse-stack/** trigger the release-synapse-stack.yaml workflow
• SSL Storage Chart: Changes to charts/ssl-storage/** trigger the release-ssl-storage.yaml workflow

Each workflow can also be triggered manually via workflow_dispatch. The workflows use chart-releaser-action to package and publish charts to the GitHub Pages repository.

Manual Release

You can also use the Makefile for manual releases:

make release VERSION=x.y.z

License

See the LICENSE file in the root of this repository.