Version: 1.0.3

Set up the development environment

This document walks you through the environment setup process for Chaos Mesh development.


Prepare the toolchain#

Make sure you have the above prerequisites met. Now follow the steps below to prepare the toolchain for compiling Chaos Mesh:

  1. Clone the Chaos Mesh repo to your local machine.

    git clone
    cd chaos-mesh
  2. Install the Kubernetes API development framework - kubebuilder and kustomize.

    make ensure-all
  3. Make sure Docker is installed and running on your local machine.

  4. Make sure Docker Regitry is running. Set the environment variable DOCKER_REGISTRY with the registry address:

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

    echo 'export PATH=$(go env GOPATH)/bin:${PATH}' >> ~/.bash_profile
    source ~/.bash_profile
  6. Check nodejs related environment.

    node -v
    yarn -v

Now you can test the toolchain by running:


If there is no error in the output, the compiling toolchain is successfully configured.

Prepare the deployment environment#

With the toolchain ready, you still need a local Kubernetes cluster as the deployment environment. Because kind is already installed, you can now set up the Kubernetes cluster directly:


The above script creates a Kubernetes cluster via Kind. When you are done with it, run the following command to delete it:

kind delete cluster --name=kind

Bootstrap Chaos Dashboard. (Optional)

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

Next step#

Congratulations! You are now all set up for Chaos Mesh development. Try the following tasks: