Skip to main content

Installation

The fastest path is the bundled elchi-stack chart, which installs every component with sensible defaults.

Add the Helm repository​

helm repo add elchi https://charts.elchi.io
helm repo update

Install with defaults​

helm install my-elchi elchi/elchi-stack \
  --set-string global.mainAddress="your-domain.com" \
  --namespace elchi-stack \
  --create-namespace

Install with a values file​

For anything beyond a quick trial, pass a values.yaml with your overrides:

global:
  mainAddress: "elchi.example.com"
  tlsEnabled: true
  jwt:
    secret: "your-secure-32-character-minimum-secret-key-here"
  versions:
    - tag: v1.6.9-v0.14.0-envoy1.38.3
helm install my-elchi elchi/elchi-stack -f values.yaml

Sign in​

Default bootstrap credentials are admin / admin. Change them on first login.

Production checklist
  • Terminate TLS at your external load balancer or ingress (the chart manages no certificates), and set global.tlsEnabled: true so the platform generates https:// URLs.
  • Replace global.jwt.secret with a 32+ character random value.
  • Disable the bundled MongoDB and point at a managed replica set.
  • Run at least 3 replicas of the controller and control-plane.