Skip to main content

Quick Start

Spin up the full Elchi stack on any Kubernetes cluster with three commands. The default chart bundles MongoDB and VictoriaMetrics so you get a working install with zero external dependencies.

Not on Kubernetes?

This page uses Helm on an existing cluster. Prefer a different substrate? Elchi installs the same control plane on Docker Swarm (one command, container-based), a single VM with kind (evaluation), or bare-metal systemd (no containers).

1. Add the Helm repository​

# Add Elchi Helm repository
helm repo add elchi https://charts.elchi.io
helm repo update

2. Install the stack​

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

3. Verify the install​

# Check pod status
kubectl get pods -n elchi-stack

# Inspect service endpoints
kubectl get svc  -n elchi-stack

4. Sign in​

Open the platform at https://your-domain.com and sign in with the default credentials:

# Default credentials
Username: admin
Password: admin
Change the default password immediately

The default admin / admin credentials exist only to bootstrap the first session. Rotate them right after signing in, and change the JWT signing secret before exposing Elchi to any untrusted network.