Skip to content

chaos-litmus Chaos Chart : Litmus

Artifacthub

This helm chart used to deploy litmus on Openshift or Kubernetes cluster. Litmus is a chaos engineering platform for designing, scheduling, and orchestrating chaos experiments on Kubernetes clusters.

This chart is part of the chaos startx helm chart series focused on deploying various kind of chaos tools for cluster infrastructure or applications chaos-testing. chaos-xxx charts.

Requirements and guidelines

Read the startx helm-repository homepage for more information on how to use these resources.

Deploy this helm chart on openshift

1. Connect to your Openshift cluster

oc login -t <token> <cluster-url>

2. Install the repository

helm repo add startx https://helm-repository.readthedocs.io/en/latest/repos/stable/

3. Get information about this chart

helm show chart startx/chaos-litmus

4. Install this component

# Install the litmus project
helm install --set project.enabled=true chaos-litmus-project  startx/chaos-litmus
# Deploy the litmus instance
helm install --set litmus.enabled=true -n chaos-litmus chaos-litmus-instance startx/chaos-litmus

Values dictionary

context values dictionary

Key Default Description
context.scope default Name of the global scope for this application (organisational tenant)
context.cluster localhost Name of the cluster running this application (platform tenant)
context.environment dev Name of the environment for this application (ex: dev, factory, preprod or prod)
context.component demo Component name of this application (logical tenant)
context.app litmus Application name (functional tenant, default use Chart name)
context.version 0.0.1 Version name of this application (default use Chart appVersion)

chaos-litmus values dictionary

Key Default Description
project {…} Configuration of the project (or namespace). Inherit from the project chart (see chart options for more options)
project.enable false Enable creation of the namespace
litmus {…} Configuration of the litmus deployment. Inherit from the official litmus chart (see chart options for more options)
litmus.enable false Enable deploying the litmus chaos engine

Values files

Default values file (values.yaml)

Simple litmus with default configuration :

  • 1 project named chaos-litmus
  • 1 scc with privileged context for 9 litmus serviceaccount
  • 1 litmus deployment using official helm chart
  • 1 route to the litmus service
# Running the default configuration
helm install --set project.enable=true chaos-litmus-project startx/chaos-litmus
helm install --set litmus.enable=true chaos-litmus-instance startx/chaos-litmus

STARTX values file (values-startx-xxx.yaml)

Same as the default configuration but with namespace prefixed with startx-

# Configuration running demo example configuration
helm install chaos-litmus-project startx/chaos-litmus -f https://raw.githubusercontent.com/startxfr/helm-repository/master/charts/chaos-litmus/values-startx-project.yaml
helm install chaos-litmus-deploy startx/chaos-litmus -f https://raw.githubusercontent.com/startxfr/helm-repository/master/charts/chaos-litmus/values-startx-deploy.yaml

Usage examples

Deploy litmus portal with web UI

Enable the LitmusChaos control plane and expose it via an OpenShift route:

# my-litmus-values.yaml
context:
  scope: myorg
  cluster: prod-cluster
  environment: chaos
  component: litmus
  app: litmus-chaos

litmus:
  enabled: true
  portal:
    enabled: true
    server:
      graphqlServer:
        genericEnv:
          CHAOS_CENTER_UI_ENDPOINT: https://litmus-frontend.chaos-litmus.apps.prod-cluster.example.com

helm install chaos-litmus-instance startx/chaos-litmus -f my-litmus-values.yaml -n chaos-litmus

Minimal deployment (backend only, no UI)

Deploy the litmus backend without the frontend portal, useful for API-only usage:

# my-litmus-minimal-values.yaml
litmus:
  enabled: true
  portal:
    enabled: true
    frontend:
      enabled: false
    server:
      enabled: true

helm install chaos-litmus-minimal startx/chaos-litmus -f my-litmus-minimal-values.yaml -n chaos-litmus

Full stack with namespace

# 1. Create the namespace
helm install chaos-litmus-project startx/chaos-litmus \
  --set project.enabled=true \
  -n default

# 2. Deploy litmus portal
helm install chaos-litmus startx/chaos-litmus \
  --set litmus.enabled=true \
  -n chaos-litmus

History

Release Date Description
16.19.59 2024-12-09 Align all chart to the 16.19.59 release
17.14.19 2025-03-12 Align all chart to the 17.14.19 release
17.14.90 2025-04-30 Publish stable release for 4.17 version
18.11.71 2025-11-27 Align all charts to the same releas
18.23.0 2026-02-28 Start 4.19 branch
19.23.15 2026-03-02 Prepare upgrading dependency to 19.23.11
19.23.17 2026-03-02 Align all dependencies to chart v19.23.11
20.14.7 2026-03-02 Update dependencies to version 20.14.0
20.14.15 2026-03-02 Update all chrat to OCP version 4.20.14
21.3.0 2026-03-02 Update all chart to OCP version 4.21.3
21.3.1 2026-03-02 Prepare release 21.3.x with 21.x dependencies
21.3.3 2026-03-02 Upgrade dependencies to v21.3.0
21.3.4 2026-06-17 21.3.9
21.3.11 2026-06-17 publish stable update for the full repository
21.3.27 2026-06-19 publish stable update for the full repository
21.3.55 2026-06-19 publish stable update for the full repository
21.3.56 2026-06-19 publish stable update for the full repository
21.3.56 2026-06-19 publish stable update for the full repository
21.3.67 2026-06-20 publish stable update for the full repository
21.3.68 2026-06-20 update basic dependencies to v21.3.70
21.3.68 2026-06-20 update all charts dependencies to v21.3.70
21.3.68 2026-06-20 update all charts dependencies to v21.3.70
21.3.106 2026-06-21 publish stable update for the full repository
21.3.107 2026-06-21 publish stable update for the full repository
21.3.167 2026-06-23 publish stable update for the full repository
21.3.181 2026-06-23 publish stable update for the full repository
21.3.182 2026-06-23 publish stable update for the full repository