Installation
Install the correct Weave binary for your machine.
Install Weave
Run the installer:
curl -fsSL <docs-origin>/install.sh | shThe script detects your operating system and CPU architecture, downloads the matching binary from the latest GitHub release, and installs it as weave.
Verify the installation:
weave --helpWindows
Run the installer from Git Bash, MSYS2, or another POSIX-compatible shell.
Custom install directory
Set WEAVE_INSTALL_DIR to install somewhere other than /usr/local/bin:
curl -fsSL <docs-origin>/install.sh | WEAVE_INSTALL_DIR="$HOME/.local/bin" shHost requirements
Weave uses Lima's native virtualization backend:
| Platform | Backend | Notes |
|---|---|---|
| macOS | Virtualization.framework (vz) | Nested virtualization requires Apple M3 or later and macOS 15 or later. |
| Linux | QEMU | Install the QEMU packages provided by your distribution. |
| Windows | QEMU | The matching qemu-system-* executable must be available on PATH. |
On Windows, you can point Weave to QEMU explicitly with QEMU_SYSTEM_X86_64 or QEMU_SYSTEM_AARCH64.
Install a specific release
Set WEAVE_VERSION to a GitHub release tag:
curl -fsSL <docs-origin>/install.sh | WEAVE_VERSION=v0.1.0 shContinue to the quick start to create your first VM.