Skip to main content

Install Wasp

You can install and run your Wasp node by cloning the repository and building the application. The instructions below will build both the Wasp node and the Wasp CLI to interact with the node from the command line.

Alternatively, you can run a Wasp node using one of the provided docker setups:

Requirements

Clone the Wasp Repository

You can get the source code of the latest Wasp version from the official repository or by running the following command:

git clone https://github.com/iotaledger/wasp

Check Out Your Version of Choice

If you want to use the latest ISC features, you should use the develop branch instead of the default main branch. You can check out develop by running the following command from the project root:

git checkout develop

Build and Install Wasp

Linux/macOS

Once you have cloned the repository and checked out your version of choice, you can build and install both wasp and wasp-cli by running the following commands from the project's root:

make install

macOS arm64 (M1 Apple Silicon)

wasmtime-go hasn't supported macOS on arm64 yet, so you should build your own wasmtime library. You can follow the README in wasmtime-go to build the library. Once you have built the wasmtime library, you can run the following commands to install the Wasp node:

go mod edit -replace=github.com/bytecodealliance/wasmtime-go=<wasmtime-go path>
make install

Microsoft Windows

On Windows, we recommend you to use WSL and follow the Linux/macOS instructions above.

Add Binaries to Path

The install command will place the applications binaries in $GOPATH/bin. Ensure that the directory is part of your $PATH environment variable. If needed, you can include this location in $PATH by adding the following line to your ~/.bash_profile:

export PATH=$PATH:$(go env GOPATH)/bin

To apply changes made to a profile file, either restart your terminal application or execute:

source ~/.bash_profile