Skip to main content

Installation

Maekon ships native installers for all three desktop platforms. Pick the path that matches your machine.

Current prerelease install (macOS / Linux)​

curl -fsSL -o /tmp/maekon-install.sh \
  https://raw.githubusercontent.com/pseudotop/maekon-client/v0.0.1-rc.6/scripts/install.sh
MAEKON_VERSION=v0.0.1-rc.6 bash /tmp/maekon-install.sh --require-signature

The current public binary release is the prerelease v0.0.1-rc.6. GitHub's latest stable download URL is unavailable until the first stable release, so current installs must pin the prerelease version.

Current prerelease install (Windows PowerShell)​

$tmp = Join-Path $env:TEMP "maekon-install.ps1"
Invoke-WebRequest -UseBasicParsing `
  -Uri "https://raw.githubusercontent.com/pseudotop/maekon-client/v0.0.1-rc.6/scripts/install.ps1" `
  -OutFile $tmp
powershell -ExecutionPolicy Bypass -File $tmp -Version v0.0.1-rc.6 -RequireSignature

Manual download​

Download the platform-specific bundle from the current prerelease page — or visit maekon.dev/download for direct buttons with file size + format.

PlatformFormatNotes
macOS Universal.dmg / .pkg / .tar.gzSigned with Developer ID. First launch may prompt Gatekeeper — right-click → Open.
Windows x64.msi / .zipMSI installer adds Maekon to PATH.
Linux x64.deb / .tar.gzDEB targets Ubuntu 22.04+, Debian 12+, Fedora 39+.

Requirements​

  • macOS 13 (Ventura) or newer · Apple Silicon + Intel
  • Windows 10 / 11 · x64
  • Linux Ubuntu 22.04+, Debian 12+, Fedora 39+ · x86_64 · X11 or Wayland (XWayland)

Verifying the signature​

All release assets ship .sha256 and .sig (ed25519) files alongside. Manual verification:

# Public key (also baked into install.sh as fallback):
PUB=fPiU9KchUIXZ7qOcjJIVp+W8rsO/WI7yStD+AiNuYvw=

# Verify (Python with PyNaCl):
python3 -c "
import base64, sys
from nacl.signing import VerifyKey
data = open(sys.argv[1], 'rb').read()
sig = base64.b64decode(open(sys.argv[1] + '.sig').read().strip())
VerifyKey(base64.b64decode('$PUB')).verify(data, sig)
print('OK')
" path/to/maekon-linux-x64.tar.gz

The release.yml workflow runs the same check (Release Reliability Smoke) on every cut.

From source​

git clone https://github.com/pseudotop/maekon-client.git
cd maekon-client
cargo build --release -p maekon-app

Requires Rust 1.88.0+ and platform-specific Tauri prerequisites — see the Tauri prerequisites guide.

Next​