Desktop app¶

The desktop build wraps the Kubus server and UI in a native window. It runs the server in-process on a random localhost port, opens it for you, and remembers your window size and position between launches.

Download¶

Grab the installer for your platform from the releases page:

Platform	File
Windows	`Kubus-Setup-<version>.exe`
macOS (universal)	`Kubus-<version>.dmg`
Linux	`Kubus-<version>.AppImage` or `.deb`

Install & launch¶

Windows macOS Linux

Run the .exe installer and follow the prompts.
Launch Kubus from the Start menu.

Windows SmartScreen may warn that the publisher is unrecognised (the builds aren't code-signed yet). Choose More info → Run anyway.

Open the .dmg and drag Kubus into Applications.
The builds aren't notarised yet, so the first launch needs one extra step:
- Right-click the app → Open, then confirm in the dialog, or
- clear the quarantine flag from a terminal:
```
xattr -dr com.apple.quarantine /Applications/Kubus.app
```

After the first launch you can open it normally from Spotlight or the Dock.

AppImageDebian / Ubuntu (.deb)

chmod +x Kubus-*.AppImage
./Kubus-*.AppImage

sudo apt install ./kubus_*_amd64.deb
kubus

Why isn't it signed?

Kubus is an open-source project without an Apple Developer or Windows code-signing certificate yet. The steps above are the standard way to run unsigned apps. You can always build from source if you'd rather not.

Updating¶

Download the newer installer and install over the top — your settings live in the browser/app profile and are preserved. There's no telemetry and no auto-updater phoning home.

Next steps¶

Quickstart

Connect your first cluster and take the tour.

Quickstart