Install & runbook
Install Commz with the right prerequisites.
These notes cover the current beta installers, stack requirements, and operational details. We are enforcing Semantic Versioning starting now.
Requirements
- Windows 11 / macOS 13+ / Ubuntu 22.04+ (or equivalent)
- 4 GB RAM minimum (8 GB recommended)
- Modern browser for web login + magic link
- Outbound HTTPS access for relay connectivity
Stack details
- Desktop client: Tauri + React
- Relay mesh: Envoy fronted services on p2p.red
- Beta auth + invites: Supabase (magic link)
- Static site: Nginx container + Envoy TLS
Install steps
- Request invite + unlock downloads.
- Download the signed build for your OS.
- Verify checksums, then install.
- Sign in with the magic link.
Known issues
Current beta caveats.
Windows
- SmartScreen warning on first install (signed, but new publisher).
- Auto-update disabled until next beta phase.
Linux
- AppImage requires executable permission.
- RPM/DEB builds may need manual icon refresh.
Network
- Corporate proxies may block relay connections.
- Beta relays are throttled during peak hours.
Versioning
Semantic Versioning (SemVer 2.0.0) starts now.
Version format: MAJOR.MINOR.PATCH. We increment MAJOR for breaking changes, MINOR for new features, PATCH for fixes. Beta releases use a pre-release tag (e.g., 0.2.0-beta.1).
Version log
- 0.2.0-beta.1 — 2026-03-10 — Invite-gated downloads, new install page.
- 0.1.0-beta.3 — 2026-03-01 — Supabase magic-link auth flow.
- 0.1.0-beta.2 — 2026-02-18 — Relay stability fixes.
- 0.1.0-beta.1 — 2026-02-01 — Initial private beta.