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

Chocolately¶

choco install waku

Docker¶

Registries:

• caffeinec/waku
• ghcr.io/caffeine-addictt/waku

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.7.3/checksums.txt'
   

2. Verify checksums signature:

   cosign verify-blob \
     --certificate-identity 'https://github.com/caffeine-addictt/waku/.github/workflows/release.yml@refs/tags/v0.7.3' \
     --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
     --cert 'https://github.com/caffeine-addictt/waku/releases/download/v0.7.3/checksums.txt.pem' \
     --signature 'https://github.com/caffeine-addictt/waku/releases/download/v0.7.3/checksums.txt.sig' \
     ./checksums.txt
   

3. 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.7.3' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  caffeinec/waku