Skip to content

Install

There are multiple ways to install Waku on your machine.

AUR

yay -S waku-bin

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

Scoop

scoop bucket add caffeine-addictt https://github.com/caffeine-addictt/scoop-bucket.git
scoop install waku

Homebrew Tap

brew install caffeine-addictt/tap/waku

Snapcraft

sudo snap install waku

Docker

Registries:

Example usage:

docker run -v "$pwd:/app" caffeinec/waku new

Linux packages

Download the .deb, .rpm or .apk packages from the release page and install them with the appropriate package manager.

After downloading, run:

dpkg -i waku*.deb
rpm -ivh waku*.rpm
apk add --allow-untrusted waku*.apk

Go

go install github.com/caffeine-addictt/waku@latest

git clone https://github.com/caffeine-addictt/waku.git
cd waku
go install -ldflags="-s -w" .

Requires Go 1.23+.

Verifying installs

Binaries

All artifacts are checksummed, and the checksum file is signed with cosign.

  1. Download the files you want, and the checksums.txt, checksums.txt.pem and checksums.txt.sig files from the releases page.
curl -O 'https://github.com/caffeine-addictt/waku/releases/download/v0.9.3/checksums.txt'
  1. Verify checksums signature:
cosign verify-blob \
  --certificate-identity 'https://github.com/caffeine-addictt/waku/.github/workflows/release.yml@refs/tags/v0.9.3' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --cert 'https://github.com/caffeine-addictt/waku/releases/download/v0.9.3/checksums.txt.pem' \
  --signature 'https://github.com/caffeine-addictt/waku/releases/download/v0.9.3/checksums.txt.sig' \
  ./checksums.txt
  1. Verify the SHA256 checksums:
sha256sum --ignore-missing -c checksums.txt

Docker images

Our docker images are signed with cosign.

Verify the signature:

cosign verify \
  --certificate-identity 'https://github.com/caffeine-addictt/waku/.github/workflows/release.yml@refs/tags/v0.9.3' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  caffeinec/waku