Skip to main content
Version: 2.2.3

Configure the Development Environment

This document describes how to configure a development environment for Chaos Mesh.

Configuration requirements

Before configuring, you need to install the development tools for Chaos Mesh.

Prepare the toolchain

After installing the above tools, follow the steps below to configure the toolchain for compiling Chaos Mesh.

  1. Clone the Chaos Mesh repository to your local server.

    git clone
    cd chaos-mesh
  2. Make sure that Docker is installed and running in your environment.

  3. Make sure Docker Registry is running. Set the environment variable DOCKER_REGISTRY as the address of Docker Registry:

    echo 'export DOCKER_REGISTRY=localhost:5000' >> ~/.bash_profile
    source ~/.bash_profile
  4. Make sure ${GOPATH}/bin is in your PATH.

    echo 'export PATH=$(go env GOPATH)/bin:${PATH}' >> ~/.bash_profile
    source ~/.bash_profile
  5. Check the configuration environment related to Node.js.

     node -v
    yarn -v
  6. Compile Chaos Mesh:


If no error occurs, you have successfully cnofigured the toolchain.

Prepare the environment for deployment

After configuring the toolchain, you need to launch a local Kubernetes cluster to deploy Chaos Mesh. Because kind is installed in the configuration requirements section, you can directly use the following command to launch a Kubernetes cluster:


When you no longer need this cluster and want to delete it, you can use the following command:

kind delete cluster --name=kind

To start Chaos Dashboard, run the following command:

cd ui && yarn
# start
yarn workspace @ui/app start:default # cross-env REACT_APP_API_URL=http://localhost:2333 BROWSER=none react-scripts start

Learn more

After finishing the above preparation, you can try to Add a New Chaos Experiment type.