Download the installer for your platform from the Kombai downloads page.
1. Kombai Mac App
System requirements
- macOS: macOS 11 (Big Sur) or later recommended (macOS 10.15 Catalina minimum).
- Processor: Apple Silicon (M1/M2/M3/M4).
- Memory / disk: 8 GB RAM recommended, ~2 GB free disk space.
How to install
- Download
Kombai-<version>-x64.dmg.- If your browser shows an “Unverified download blocked” warning, see Browser download warnings at the end of this page.
- Open the
.dmgand drag Kombai into your Applications folder. - Launch Kombai from Applications (or Spotlight).
- If macOS shows an “unidentified developer” warning, right-click the app → Open, or go to System Settings → Privacy & Security → Open Anyway.
2. Kombai Windows App
System requirements
- OS: Windows 10 or Windows 11, 64-bit (x64).
- Memory / disk: 8 GB RAM recommended, ~2 GB free disk space.
How to install
- Download
Kombai-<version>-x64.exe.- If your browser shows an “Unverified download blocked” warning, see Browser download warnings at the end of this page.
- Run the installer.
- If Windows SmartScreen shows “Windows protected your PC”, click More info → Run anyway. Kombai is code-signed by Kombai Inc., and you can confirm the publisher on the More info screen before continuing. SmartScreen surfaces this prompt for builds it hasn’t yet seen installed widely, so it reflects how new the release is rather than anything it found wrong with the file. The prompt fades as a release picks up installs.
- Complete the setup and launch Kombai from the Start menu or desktop shortcut.
3. Kombai Linux App
Kombai ships on Linux as an AppImage.System requirements
- Architecture: 64-bit x86_64 (check with
uname -m→ should printx86_64). - Distribution: A modern 64-bit distro with glibc 2.31 or newer — e.g. Ubuntu 20.04+, Debian 11+, Fedora 34+, or equivalent.
- FUSE: Required to run AppImages (
libfuse2on Ubuntu/Debian). - Memory / disk: 8 GB RAM recommended, ~2 GB free disk space.
How to install / run
-
Download
Kombai-<version>-x86_64.AppImage.- If your browser shows an “Unverified download blocked” warning, see Browser download warnings at the end of this page.
-
Make the AppImage executable and run it:
If you see an “AppImages require FUSE” error, install it:
-
If you see a
chrome-sandbox … 4755/ SUID sandbox error (common on Ubuntu 24.04 and newer): Recent Ubuntu blocks the user namespaces Kombai’s browser sandbox needs. Re-enable them (recommended — keeps the sandbox on):As a quick workaround only (this disables the sandbox and does not reliably cover the Kombai Browser), you can instead run with--no-sandbox. - To get the proper app icon (instead of a generic gear) and add Kombai to your applications menu, install AppImageLauncher, then double-click the AppImage and choose Integrate and run.
4. Updating Kombai
Kombai updates itself automatically on macOS, Windows, and Linux. New versions download in the background and apply the next time you restart the app. You can also check on demand: open the Kombai menu in the menu bar (macOS) or the app menu (Windows and Linux) and choose Check for Updates…. If a newer version exists, Kombai downloads it and prompts you to restart.5. Browser download warnings
On any platform, your browser may warn about the Kombai installer or block it outright. These are browser-level checks — separate from macOS Gatekeeper and Windows SmartScreen — and they don’t mean the file is unsafe. In Chrome:- “Unverified download blocked” — shown when Safe Browsing is turned off, so Chrome has no way to check the file. Click the download entry, then Download unverified file. To stop seeing it, re-enable Safe Browsing under Settings → Privacy and security → Safe Browsing → Standard protection.
- ”… isn’t commonly downloaded” / “may be dangerous” — shown for installers Chrome hasn’t seen often yet, which is normal for a new release. Open the ⋮ menu on the download and click Keep.