1. 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 for Windows — this gives you
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.
2. Kombai Mac App
System requirements
- macOS: macOS 13 (Ventura) or later.
- Processor: Apple Silicon (M1/M2/M3/M4).
- Memory / disk: 8 GB RAM recommended, ~2 GB free disk space.
How to install
- Download for macOS — this gives you
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.
3. Kombai Linux App
Kombai ships on Linux in three formats — a.deb package (Debian/Ubuntu), an .rpm package (Fedora/RHEL/openSUSE), and a distro-independent .AppImage. Pick whichever fits your distribution.
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 only for the AppImage (
libfuse2on Ubuntu/Debian). - Memory / disk: 8 GB RAM recommended, ~2 GB free disk space.
Option A — Debian / Ubuntu (.deb)
-
Download the
.debpackage.- If your browser shows an “Unverified download blocked” warning, see Browser download warnings at the end of this page.
-
Install it (this also pulls in any dependencies):
-
Launch Kombai from your applications menu, or run
kombaifrom a terminal.
Option B — Fedora / RHEL / openSUSE (.rpm)
-
Download the
.rpmpackage.- If your browser shows an “Unverified download blocked” warning, see Browser download warnings at the end of this page.
-
Install it with your package manager:
-
Launch Kombai from your applications menu, or run
kombaifrom a terminal.
Option C — AppImage (any distro)
-
Download the
.AppImage— this gives youKombai-<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: choose Kombai > Check for Updates… in the menu bar (macOS) or Help > Check for Updates… (Windows and Linux, from the menu button at the top of the sidebar). 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.
6. Sign in to Kombai
When you open Kombai for the first time, it shows the Get started with Kombai screen.- Click Sign Up to create an account, or click Log in if you already have one. Kombai opens the sign-in page in your browser.
- Complete sign-in in your browser. Kombai shows Signing you in while it waits.
- Return to Kombai. When sign-in finishes, the home screen opens.