litmus-docs/website/docs/litmusctl/installation.md

7.4 KiB

id title sidebar_label
installation Litmusctl Installation

The Litmuschaos command-line tool, litmusctl, allows you to manage litmuschaos's agent plane. You can use litmusctl to create agents, 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 agents. 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.

Installation

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

Platforms v0.7.0 v0.6.0 v0.5.0 v0.4.0 master(Unreleased)
litmusctl-darwin-amd64 (MacOS) Click here Click here Click here Click here Click here
litmusctl-linux-386 Click here Click here Click here Click here Click here
litmusctl-linux-amd64 Click here Click here Click here Click here Click here
litmusctl-linux-arm Click here Click here Click here Click here Click here
litmusctl-linux-arm64 Click here Click here Click here Click here Click here
litmusctl-windows-386 Click here Click here Click here Click here Click here
litmusctl-windows-amd64 Click here Click here Click here Click here Click here
litmusctl-windows-arm Click here Click here Click here Click here Click 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