Skip to main content

Installation

Install Wasmrun using one of the following methods based on your operating system and preferences.

The easiest way to install Wasmrun is via Cargo, Rust's package manager:

cargo install wasmrun

This installs the latest stable version from crates.io.

Requirements:

  • Rust 1.85 or higher
  • Cargo (comes with Rust)

If you don't have Rust installed, get it from rustup.rs.

Prebuilt Packages​

DEB Package (Debian/Ubuntu/Pop!_OS)​

For Debian-based Linux distributions, download and install the DEB package:

  1. Download the latest .deb file from GitHub Releases

  2. Install the package:

# Install the downloaded DEB package
sudo apt install ./wasmrun_*.deb

# If there are dependency issues, fix them
sudo apt install -f

Supported distributions:

  • Ubuntu 20.04+
  • Debian 11+
  • Pop!_OS 20.04+
  • Linux Mint 20+
  • Other Debian-based distributions

RPM Package (Fedora/RHEL/CentOS)​

For Red Hat-based Linux distributions, download and install the RPM package:

  1. Download the latest .rpm file from GitHub Releases

  2. Install the package:

# Install using rpm
sudo rpm -i wasmrun-*.rpm

# Or using dnf (Fedora/RHEL 8+)
sudo dnf install ./wasmrun-*.rpm

# Or using yum (older versions)
sudo yum install ./wasmrun-*.rpm

Supported distributions:

  • Fedora 35+
  • RHEL 8+
  • CentOS Stream 8+
  • Rocky Linux 8+
  • AlmaLinux 8+

Arch Linux (AUR)​

For Arch Linux and Arch-based distributions, Wasmrun is available on the AUR as a community-maintained package that installs the prebuilt binary.

Using an AUR helper such as yay or paru:

yay -S wasmrun-bin
# or
paru -S wasmrun-bin

Or install manually with makepkg:

git clone https://aur.archlinux.org/wasmrun-bin.git
cd wasmrun-bin
makepkg -si

Supported distributions:

  • Arch Linux
  • Manjaro
  • EndeavourOS
  • Other Arch-based distributions

Note: The AUR package is maintained by the community and may lag slightly behind the latest release.

From Source​

Build and install Wasmrun from source for the latest development version or if prebuilt packages aren't available for your platform:

# Clone the repository
git clone https://github.com/anistark/wasmrun.git
cd wasmrun

# Install from source
cargo install --path .

This will compile Wasmrun and install it to ~/.cargo/bin/wasmrun.

Build requirements:

  • Rust 1.85 or higher
  • Git

Release Tracking​

Stay updated with the latest releases:

Verify Installation​

After installation, verify that Wasmrun is working correctly:

# Check version
wasmrun --version

# Should output something like: wasmrun 0.20.0

# View available commands
wasmrun --help

Installing Language Plugins​

Wasmrun supports multiple languages through plugins. After installing Wasmrun, you can install language support:

# List available plugins
wasmrun plugin list

# Install Rust support
wasmrun plugin install wasmrust

# Install Go support
wasmrun plugin install wasmgo

# Install Python support
wasmrun plugin install waspy

# Install AssemblyScript support
wasmrun plugin install wasmasc

Note: C/C++ support is built-in and doesn't require a separate plugin.

Updating Wasmrun​

Cargo Installation​

If you installed via Cargo, update with:

cargo install wasmrun --force

Package Manager Installation​

For DEB/RPM packages:

  1. Download the latest package from GitHub Releases
  2. Install it (will upgrade existing installation)

For the AUR package, update with your AUR helper:

yay -S wasmrun-bin
# or
paru -S wasmrun-bin

From Source​

cd wasmrun
git pull
cargo install --path . --force

Common Installation Issues​

Command Not Found​

If wasmrun is not found after installation:

  1. Check cargo bin directory is in PATH:
echo $PATH | grep cargo
  1. Add to PATH (if missing):
# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/.cargo/bin:$PATH"

# Reload shell
source ~/.bashrc  # or source ~/.zshrc

Permission Denied (Linux/macOS)​

If you get permission errors:

# Ensure the binary is executable
chmod +x ~/.cargo/bin/wasmrun

Plugin Installation Fails​

If plugin installation fails:

  1. Check internet connection - Plugins are downloaded from crates.io
  2. Verify disk space - Plugins are installed to ~/.wasmrun/plugins/
  3. Check permissions - Ensure you can write to ~/.wasmrun/
# Create directory if it doesn't exist
mkdir -p ~/.wasmrun/plugins

Uninstallation​

Cargo Installation​

cargo uninstall wasmrun

# Also remove plugins and cache (optional)
rm -rf ~/.wasmrun

DEB Package​

sudo apt remove wasmrun

RPM Package​

sudo rpm -e wasmrun
# or
sudo dnf remove wasmrun

Arch Linux (AUR)​

sudo pacman -R wasmrun-bin

Next Steps​

Now that Wasmrun is installed, continue to the Quick Start guide to create your first WebAssembly project, or explore the Language Guides to learn about using Wasmrun with your preferred programming language.