Installation and first start

Install Kubby on Windows 11, create your account and add your first cluster. It all takes a few minutes.

System requirements

The operating system, runtime and what Monitoring, Argo CD and Ask Kubby need are listed in the system requirements on the download page.

Installation

  1. Download the installer. Kubby is free; get it from the Download page.
  2. Run it. Kubby installs into your user account; it does not ask for administrator rights.
  3. Start it. Open Kubby from the Start menu.

First start: create an account

On first start Kubby creates a Kubby account for this Windows user. The account and all data stay on your computer.

  1. Enter your details: first name, last name, user name and password.
  2. Scan the QR code with an authenticator app (Microsoft Authenticator, Google Authenticator and others); it adds a "Kubby" entry.
  3. Verify the code: type the 6-digit code from the app.
  4. Keep the recovery codes: 10 single-use codes are shown. If you lose access to your phone, you sign in with them.
Session length. A sign-in lasts 8 hours. Reopening Kubby within that time does not ask again. Account and security

Updates

Kubby asks kubby.tech for a new release at start and every hour. When there is one, a banner says Kubby <version> is available.

  • Help → Check for Updates… checks at once and shows the newest version with its release date and notes.
  • Install and restart downloads the update and installs it only after you click it. Kubby restarts by itself.
  • Before installing, Kubby checks the download against Kubby's signature. A file that does not match is not installed.

If your network uses a proxy, set it in Preferences → Proxy. Without internet Kubby works as usual; it only cannot see new releases. What changed in each version is in the release notes.

Next step

Your account is ready. Now add your first cluster.