Installation
Install WWKG and verify your environment.
Prerequisites
- macOS (Apple Silicon), Linux (x86_64 / arm64), or Windows (x86_64)
Quick install
On Ubuntu, install WWKG from the Snap Store:
sudo snap install wwkgThe wwkg install command is the repair and reinstall entry point after WWKG
is present on the machine. On Ubuntu it installs or refreshes the Snap package
by default.
On macOS, Debian, RPM-based Linux distributions, or Windows, use the platform installer from the download page or one of the package-manager options below.
The shell installer remains available for non-interactive Linux installs:
curl -fsSL https://wwkg.io/install.sh | shOn Windows (PowerShell):
irm https://wwkg.io/install.ps1 | iexPackage managers
Snap (Ubuntu)
sudo snap install wwkgAPT (Debian / Ubuntu administrators)
curl -fsSL https://releases.wwkg.io/apt/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/wwkg-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/wwkg-archive-keyring.gpg] https://releases.wwkg.io/apt stable main" | sudo tee /etc/apt/sources.list.d/wwkg.list
sudo apt update && sudo apt install wwkgThe APT repository publishes signed metadata for amd64 and arm64. Use this
path for managed Debian/Ubuntu fleets that intentionally avoid Snap.
Homebrew (macOS / Linux)
brew install dataroadinc/tap/wwkgwinget (Windows)
winget install DataRoad.WWKGNative installers
Download the installer for your platform directly:
| Platform | Installer | Command |
|---|---|---|
| macOS (Apple Silicon) | wwkg.pkg | Double-click, or sudo installer -pkg wwkg.pkg -target / |
| Linux x86_64 (deb) | wwkg_amd64.deb | Use APT above for normal installs; local .deb files are for manual testing |
| Linux arm64 (deb) | wwkg_arm64.deb | Use APT above for normal installs; local .deb files are for manual testing |
| Linux x86_64 (rpm) | wwkg.x86_64.rpm | sudo rpm -i wwkg.x86_64.rpm |
| Linux arm64 (rpm) | wwkg.aarch64.rpm | sudo rpm -i wwkg.aarch64.rpm |
| Windows (x86_64) | wwkg.msi | Double-click, or msiexec /i wwkg.msi |
Upgrade
Once installed, use the built-in upgrade command to stay current:
wwkg system upgrade # Upgrade to the latest version
wwkg system upgrade --check # Check if an upgrade is available
wwkg system upgrade --version X # Install a specific version
wwkg system upgrade --rollback # Roll back to the previous versionVerify the installation
wwkg system versionYou should see version and protocol information printed to the terminal.
Next steps
Continue to the Quickstart to initialize a node and run your first query.