Installation
We will guide you through installation of wash
, the wasmCloud Shell, which gives you the tools to install, run, and develop with wasmCloud.
- Ubuntu/Debian
- Fedora
- Snap
- MacOS
- Windows
- Rust
- Source
- 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
cd wash
cargo build --release
./target/release/wash
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.
With the 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 -d
flag:
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
Once 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.