Skip to main content

Installation Guide

KusionStack consists of "three major pieces", namely:

  • Kusion: the engine of KusionStack for parsing users' intentions described in Konfig and making them effective in infrastructures.
  • KCL: KCL(Kusion Configuration Language is an open-source constraint-based record and functional language.
  • Konfig: Konfig is the mono repository of the infra configuration in KCL.

The first two are binary tools that need to be downloaded and installed, and the third is a Git repository. For binary tools, KusionStack provides a one-click installation for everybody.

One-click installation

The preferred method for installing on Mac and Linux is to use the brew package manager. You can also run go install if your environment is available for golang.

brew install KusionStack/tap/kusion

KCL is embedded in Kusion, so you don't need to install it again. If you are interested in other versions of KCL, please refer to KCL Installation.


If you need a multi-version management tool for Kusion and KCL, please refer to Kusionup Tools.

No Installation

If the upper installation doesn't support your environment, you can use the docker image of Kusion instead. First, prepare the Docker service and start it. Then use the docker pull command to get an available Kusion image.

docker pull kusionstack/kusion:latest

Next, run Kusion in an interactive mode:

docker run --rm -it kusionstack/kusion:latest bash

No Installation: KusionStack QuickStart Trial with GitHub Codespaces

You can also start a KusionStack quickstart trial with GitHub Codespaces. With no installation required, you can create a workspace on Konfig) with built-in Kusion and IDE extension support via merely a browser connected to the Internet in seconds.


For a detailed guide, please refer to the Start a Quick Start Trial with KusionStack in GitHub Codespaces