Skip to main content
Version: Next

Litmusctl


The Litmuschaos command-line tool, litmusctl, allows you to manage litmuschaos's chaos delegate plane. You can use litmusctl to connect and disconnect chaos delegates, create chaos scenarios, project, and manage multiple litmuschaos accounts.

Prerequisites​

Litmusctl CLI requires the following things:

  • kubeconfig - litmusctl needs the kubeconfig of the k8s cluster where we need to connect litmus chaos delegates. The CLI currently uses the default path of kubeconfig i.e. ~/.kube/config.
  • kubectl - litmusctl is using kubectl under the hood to apply the manifest.

    To install kubectl, follow: kubectl

Usage​

For more information including a complete list of litmusctl operations, see the litmusctl reference documentation.

Compatibility matrix​

To check compatibility of litmusctl with Chaos Center

litmusctl versionLowest Chaos Center supported versionHighest Chaos Center supported version
0.7.02.4.02.8.0
0.8.02.4.02.8.0
0.9.02.4.02.8.0
0.10.02.9.03.0.0-beta8
0.11.02.9.03.0.0-beta8
0.12.02.9.03.0.0-beta8
0.13.02.9.03.0.0-beta8
0.14.02.9.03.0.0-beta8
0.15.02.9.03.0.0-beta8
0.16.02.9.03.0.0-beta8
0.17.02.9.03.0.0-beta8
0.18.02.9.03.0.0-beta8
0.19.02.9.03.0.0-beta8
0.20.02.9.03.0.0-beta8
0.21.02.9.03.0.0-beta8
0.22.02.9.03.0.0-beta8

Installation​

To install the latest version of litmusctl follow the below steps:

Platforms0.22.00.21.00.20.00.19.00.18.00.17.00.16.00.15.0master(Unreleased)
litmusctl-darwin-amd64 (MacOS)Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-linux-386Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-linux-amd64Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-linux-armClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-linux-arm64Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-windows-386Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-windows-amd64Click hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here
litmusctl-windows-armClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick hereClick here

Linux/MacOS​

  • Extract the binary
tar -zxvf litmusctl-<OS>-<ARCH>-<VERSION>.tar.gz
  • Provide necessary permissions
chmod +x litmusctl
  • Move the litmusctl binary to /usr/local/bin/litmusctl. Note: Make sure to use root user or use sudo as a prefix
mv litmusctl /usr/local/bin/litmusctl
  • You can run the litmusctl command in Linux/macOS:
litmusctl <command> <subcommand> <subcommand> [options and parameters]

Windows​

  • Extract the binary from the zip using WinZip or any other extraction tool.

  • You can run the litmusctl command in windows:

litmusctl.exe <command> <subcommand> <subcommand> [options and parameters]
  • To check the version of the litmusctl:
litmusctl version