Kubernetes (Helm Charts)

Official Helm charts for deploying Synaplan and its infrastructure components on Kubernetes live in the synaplan-charts repository.

What's in the repository

  • synaplan — the platform chart
  • triton — optional NVIDIA Triton Inference Server with TensorRT-LLM support

Synaplan uses BGE-M3 as its embedding model for RAG-powered semantic search across 100+ languages. Embeddings (and chat LLMs) run on whichever backend you configure:

  • Ollama — recommended for most deployments; simple setup, CPU and GPU inference, broad model support.
  • NVIDIA Triton — for production GPU clusters requiring maximum throughput with TensorRT-LLM optimized models.

Prerequisites

  • Kubernetes 1.24+
  • Helm 3.14+
  • kubectl configured for your cluster

Install from GHCR

Charts are published to the GitHub Container Registry as OCI artifacts and are publicly accessible:

# Stable release (recommended for production)
helm install synaplan oci://ghcr.io/metadist/synaplan-charts/synaplan --version 0.1.0
helm install triton oci://ghcr.io/metadist/synaplan-charts/triton --version 0.1.0

Stable releases (0.1.0, 0.2.0, …) are created from git tags and are immutable; development builds (0.0.0-dev.<commit>) are built from main on every push and are for testing only.

Install from source

git clone https://github.com/metadist/synaplan-charts.git
cd synaplan-charts
helm install synaplan ./charts/synaplan
helm install triton ./charts/triton

Example deployment

A complete example with Synaplan, Triton, and MariaDB (driven by helmfile) is available at deployments/synaplan-with-triton/ — see its README for prerequisites and configuration options.

For chart values, configuration reference, and the release process, use the synaplan-charts repository directly — its READMEs are generated from the charts and always current.