Skip to main content


It is recommended to install Kusion through the kusionup tool, which is an elegant kusion multi-version management tool, you can use it:

  • Install any version of kusion with one click
  • Flexible switching between different versions of kusion
  • Customize local kusion version

1. Install Kusionup

One-click installation with the following command kusionup:

brew install KusionStack/tap/kusionup && kusionup init --skip-prompt && source $HOME/.kusionup/env

Upgrade kusionup

brew update
brew upgrade KusionStack/tap/kusionup

The script will crate a $HOME/.kusionup directory, which will contain:

  • $HOME/.kusionup/bin directory include the kusionup binary file
  • $HOME/.kusionup/env file is used to declare kusionup and kusion environment variables required by the technology stack
  • $HOME/.kusionup/current soft link is used to identify the currently active kusion version
  • $HOME/.kusionup/$VERSION directories represent different kusion version directories, such as the latest version installed by default $HOME/.kusionup/latest

💡 Install the custom version

The above script will install the latest kusion version ( latest) by default. If you want to customize the default installation version , use the following command:

brew install KusionStack/tap/kusionup && kusionup init --skip-install && source $HOME/.kusionup/env && kusionup reinstall latest

**💡 Installation failure troubleshooting:

❓ Issue 1:M1 Mac Openssl dylib library cannot be found or SSL module is not available

  1. Make sure you have a homebrew arm64e-version installed in /opt/homebrew, otherwise to install the arm version of brew with the following command
/bin/bash -c "$(curl -fsSL"
# add to path environment
export PATH=/opt/homebrew/bin:$PATH
  1. Use brew to install openssl@1.1
brew install openssl@1.1

❓ Issue 2: mac KCLVM gettext dylib cannot be found


  • Use the which command to find the location of your own gettext (assuming /Users/UserName/tools/homebrew/bin/gettext)
which gettext
  • Use the otool -L command to get the location of libintl.8.dylib
C02Y90Q4JHD2:bin yueyi$ otool -L /Users/yueyi/tools/homebrew/bin/gettext
/System/Library/Frameworks/CoreFoundation.framework/Versions/A/CoreFoundation (compatibility version 150.0.0, current version 1675.129.0)
/Users/yueyi/tools/homebrew/Cellar/gettext/0.21/lib/libintl.8.dylib (compatibility version 11.0.0, current version 11.0.0)
/usr/lib/libiconv.2.dylib (compatibility version 7.0.0, current version 7.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1281.100.1)
  • Copy /Users/yueyi/tools/homebrew/Cellar/gettext/0.21/lib/libintl.8.dylib to /usr/local/opt/gettext/lib/libintl.8.dylib

2. Manage Multi Kusion Versions

After executing the installation script, kusionup and a default kusion version is installed. Use kusionup to check the all installed version:

$ kusionup
Use the arrow keys to navigate: ↓ ↑ → ←
? Select a version:
▸ latest

Execute to `kusionup ls-ver' to list all installable kusionversions from the built-in installation sources :

$ kusionup ls-ver

Execute to kusionup install $VERSION to install specified version:

# choose the cdn to speed up installation
$ kusionup install cdn@latest
Downloaded 0.0% ( 2426 / 139988826 bytes) ...
Downloaded 11.4% ( 16003466 / 139988826 bytes) ...
Downloaded 21.0% ( 29433014 / 139988826 bytes) ...
Downloaded 32.2% ( 45077686 / 139988826 bytes) ...
Downloaded 41.9% ( 58642898 / 139988826 bytes) ...
Downloaded 51.2% ( 71647010 / 139988826 bytes) ...
Downloaded 61.6% ( 86258486 / 139988826 bytes) ...
Downloaded 71.2% ( 99667706 / 139988826 bytes) ...
Downloaded 81.5% (114078806 / 139988826 bytes) ...
Downloaded 91.5% (128134166 / 139988826 bytes) ...
Downloaded 100.0% (139988826 / 139988826 bytes)
INFO[0055] Unpacking /root/.kusionup/kusion@latest/kusion-linux.tgz ...
INFO[0061] Success: latest downloaded in /root/.kusionup/kusion@latest
INFO[0061] Default Kusion is set to 'latest'

$ kusion version
releaseVersion: v0.4.1

Execute to kusionup show to see the current kusion version:

$ kusionup show
| cdn@latest | * |
| cdn@v0.4.1 | |

Execute to kusionup remove $VERSION to delete specified version:

# try remove the latest version
$ kusionup remove latest
INFO[0000] Removing latest

$ kusionup
Use the arrow keys to navigate: ↓ ↑ → ←
? Select a version:
▸ cdn@v0.4.1 # there is no latest version

3. Kusionup Help

$ kusionup -h
The Kusion installer

kusionup [flags]
kusionup [command]

Available Commands:
default Set the default Kusion version
help Help about any command
install Install Kusion with a version
ls-ver List Kusion versions to install
remove Remove Kusion with a version
show Show installed Kusion
version Show kusionup version

-h, --help help for kusionup
-v, --verbose Verbose

Use "kusionup [command] --help" for more information about a command.

4. Kusionup Tips

How to add custom kusion version to the kusionup toggle list?

We can use the following method to add any local version which may be used for debugging.

# install a debug version
$ mv $HOME/.kusion $HOME/.kusionup/kusion-debug

# switch to the debug version
$ kusionup
Use the arrow keys to navigate: ↓ ↑ → ←
? Select a version:
▸ debug

Note: In .kusionup .kusionup, the subdirectory name must start with "kusion-" and the suffix is ​​the version number;

5. VS Code Extension

In order to improve the efficiency of IDE development of KCL, Kusion provides plug-n support for VS Code online and native environment. The online version can be opened from address, and then install "KCL for plugin", the effect is as follows:

Native VS Code can install a complete KCL plugin , providing features such as highlighting, auto-completion (keyword completion, etc.), jump, hover, outline, etc. Although the plugin is not a necessary part of Kusion, it is recommended to install it to improve efficiency.