litmuschaos/litmus

Documentation Missing: Installing Litmus Without ChaosCenter (UI)

Open

#5432 opened on Feb 5, 2026

View on GitHub
 (11 comments) (1 reaction) (0 assignees)HTML (3,702 stars) (574 forks)batch import
area/litmus-docsgood first issuekind/docs

Description

I couldn’t find any official documentation for installing LitmusChaos without deploying the ChaosCenter (UI).

My goal is to run LitmusChaos purely as infrastructure i.e., core + agents + CRDs and trigger experiments via CI/CD pipelines, without using the UI. I want a setup where chaos experiments can be created and executed programmatically, without deploying ChaosCenter.

I noticed that Helm charts like litmus-core and litmus-agent exist, which suggests this deployment model is supported. However, there is no official guide or best practice document covering this approach.

It seems that litmusctl can be used to manage infrastructure and experiments without the ChaosCenter.

Would be great to provide related documentation.

Contributor guide

Tech stack
kubernetesdockershell
Domain
documentationdevops
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Kubernetes basicsHelm package managerChaos engineering concepts
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80
Research direction
Review the existing Helm charts (litmus core, litmus agent) in the repository's charts directory. Examine the docs folder for existing installation guides and the litmusctl CLI documentation. Check the issue comments for any maintainer guidance. Create a new documentation page covering headless installation steps, including using litmusctl to manage experiments programmatically.