Skip to main content

Release Artifacts

This page is the canonical release file catalog.

If you are looking at a GitHub release and unsure what to download, start here.

Quick Download Guide

If You NeedDownload This FileWhy
Linux desktop (portable)wavry-desktop-tauri-linux-x64.AppImageRuns without system package install
Linux desktop (Debian/Ubuntu)wavry-desktop-tauri-linux-x64.debNative package install via APT/dpkg
Linux desktop (Fedora/RHEL)wavry-desktop-tauri-linux-x64.rpmNative package install via DNF/RPM
Windows desktopwavry-desktop-tauri-windows-x64.exeDesktop app executable
macOS desktop (Native Swift)wavry-desktop-native-macos-arm64.dmgNative Swift app DMG package
Gateway auth/control plane (Docker)ghcr.io/<owner>/<repo>/gateway:<tag>Control plane service container
Relay service (Docker)ghcr.io/<owner>/<repo>/relay:<tag>UDP relay service container
Host runtime servicewavry-server-<platform>-<arch>[.exe]Host runtime for capture/stream
Android mobile appwavry-mobile-android-arm64-release.apkMobile Android client
Android Quest appwavry-quest-android-arm64-release.apkQuest client

Naming Rules

Every release file uses:

<component>-<variant>-<platform>-<arch>[.<ext>]

Examples:

  • wavry-server-windows-x64.exe
  • wavry-desktop-tauri-linux-x64.deb
  • wavry-desktop-native-macos-arm64.dmg

Full Asset Catalog

File PatternCategoryPlatformArchitecturePurpose
wavry-master-<platform>-<arch>[.exe]Backend ServiceLinux/macOS/Windowsx64/arm64Master coordination service binary
wavry-server-<platform>-<arch>[.exe]Backend ServiceLinux/macOS/Windowsx64/arm64Host runtime service
wavry-desktop-tauri-linux-x64.AppImageDesktop AppLinuxx64Portable Linux desktop package
wavry-desktop-tauri-linux-x64.debDesktop AppLinuxx64Debian/Ubuntu package
wavry-desktop-tauri-linux-x64.rpmDesktop AppLinuxx64Fedora/RHEL package
wavry-desktop-tauri-windows-x64.exeDesktop AppWindowsx64Windows desktop executable
wavry-desktop-native-macos-arm64.dmgDesktop AppmacOSarm64Native Swift desktop DMG
wavry-mobile-android-arm64-release.apkAndroid AppAndroidarm64Mobile client APK
wavry-quest-android-arm64-release.apkAndroid AppAndroid (Quest)arm64Quest client APK
SHA256SUMSIntegrityAlln/aSHA-256 checksums for all shipped files
release-manifest.jsonMetadataAlln/aMachine-readable file/platform/arch/checksum manifest
release-signatures/<artifact>.sigSignatureAlln/aSigstore signature for each shipped artifact
release-signatures/<artifact>.pemSignatureAlln/aSigstore signing certificate for each artifact

Docker-Only Control Plane Components

Wavry distributes gateway and relay as container images, not release binaries:

  • ghcr.io/<owner>/<repo>/gateway:<tag>
  • ghcr.io/<owner>/<repo>/relay:<tag>

Tag guidance:

  • Use vX.Y.Z (or vX.Y.Z-canary... / vX.Y.Z-unstable...) for release-pinned deployments
  • Use main/latest only for fast-moving development environments

Linux Package Install Notes

AppImage

chmod +x wavry-desktop-tauri-linux-x64.AppImage
./wavry-desktop-tauri-linux-x64.AppImage

Debian/Ubuntu

sudo dpkg -i wavry-desktop-tauri-linux-x64.deb
sudo apt-get install -f

Fedora/RHEL

sudo dnf install ./wavry-desktop-tauri-linux-x64.rpm

What Should Never Be in a Release

  • CI intermediary directories
  • target/ tree dumps
  • Debug binaries
  • Build cache content
  • Temporary helper files

Integrity Verification

sha256sum -c SHA256SUMS

If any file does not verify, discard the artifact and redownload.

Signature Verification (Sigstore)

Each release artifact is signed with keyless Sigstore (cosign) and shipped with:

  • release-signatures/<artifact>.sig
  • release-signatures/<artifact>.pem

Example verification:

cosign verify-blob \
--signature release-signatures/wavry-server-linux-x64.sig \
--certificate release-signatures/wavry-server-linux-x64.pem \
wavry-server-linux-x64