Getting started

Install the Wago manager, select a runtime channel, and run a small WebAssembly module.

Prerequisite

The source installer requires Go 1.22 or newer. It prefers Git and can fall back to a GitHub source archive when necessary.

Install the manager

curl -fsSL https://wago.sh/install.sh | sh

The interactive installer defaults to ~/.wago/bin and can add that directory to your shell path.

Choose a runtime

Your channel preference is shared with other channel tabs across the documentation.

wago version install canary

Download a small module

curl -LO https://raw.githubusercontent.com/wago-org/wago/main/tests/testdata/fib.wasm

Run it

wago run fib.wasm 30

run validates and compiles the module before invoking the exported function.

What was installed?

On macOS, Wago uses the following default layout. Linux uses the corresponding XDG data, config, and cache directories; WAGO_HOME can override both layouts.

• ▾~/.wago/
  • ▾bin/runtime-independent manager
  • ▾versions/installed runtime channels and releases

Next steps

⚙

Configure a project →

Add project-level settings and runtime options.

✦

Browse plugins →

Extend Wago with host integrations and runtime services.