We will guide you through installation of
wash, the wasmCloud Shell, which gives you the tools to install, run, and develop with wasmCloud.
- Docker Compose
curl -s https://packagecloud.io/install/repositories/wasmcloud/core/script.deb.sh | sudo bash
sudo apt install wash
curl -s https://packagecloud.io/install/repositories/wasmcloud/core/script.rpm.sh | sudo bash
sudo dnf install wash
snap install wash --devmode --edge
brew tap wasmcloud/wasmcloud
brew install wash
choco install wash
If your platform isn't listed,
wash can be installed with
cargo and a properly installed Rust toolchain.
cargo install wash-cli
The wash repository is open source on GitHub and can be cloned and built locally directly. With a Rust toolchain,
wash is easy to build from source
git clone https://github.com/wasmcloud/wash.git
cargo build --release
If you only use Docker Compose without installing
wash, you'll only be able to interact with wasmCloud via the Web Dashboard.
Download the sample Docker Compose file and put it into your work directory.
This compose file will run NATS, a local OCI registry, a Redis container, Grafana and Tempo for OTEL tracing, and the
wasmcloud_host container. In this format it's easy to run all the necessary services for a wasmCloud host with only a docker installation.
docker-compose.yml file in the current directory, start the processes with
docker compose up
The host will run until you type ctrl-c or close the terminal window. To start the docker compose process in the background, add a
docker compose up -d
If the wasmCloud host is running in docker in the background, you can view its logs (live) with
docker logs -f wasmcloud
That's it! Let's move on to Getting started
wash is installed, simply run
wash up. This will download and start NATS and wasmCloud for you, printing logs to the terminal. You can exit at any time by pressing
ctrl-c. Now, you're ready to proceed onto Getting started.