Skip to content

Sign up and install the CLI

Sign up to Kupe Cloud and get the kupe CLI fully configured for your tenant.

1. Create your tenant

Section titled “1. Create your tenant”
  1. Go to kupe.cloud/signup.
  2. Enter your first name, last name, and work email.
  3. Enter your company name. Kupe derives your tenant name from it and shows you the result under the field before you submit. If the form also asks for an invite code, enter it first: the rest of the fields stay disabled until the code validates.
  4. Accept the Terms of Service and Privacy Policy, then submit.
  5. Open the verification email and click the link.
  6. Set a password.

You are now the owner of a new tenant. Sign into console.kupe.cloud with the same credentials.

2. Install the CLI

Section titled “2. Install the CLI”

Install script (no prerequisites, no sudo):

Terminal window
curl -fsSL https://get.kupe.cloud | sh

Or via Homebrew (auto-updates + completions + man page):

Terminal window
brew install kupecloud/tap/kupe

Verify:

Terminal window
kupe version --short

For the full install matrix (go install, direct binary download, update commands, uninstall instructions, and macOS/Windows trust-prompt notes), see Kupe CLI.

3. Log in

Section titled “3. Log in”
Terminal window
kupe auth login --tenant <your-tenant>

The default --method oidc runs an RFC 8628 device-code flow through the Kupe identity service. The CLI prints a short user code plus a verification URL, opens your browser (best-effort), and waits for you to approve. Sign in with the same email and password you set up in step 1. It works identically on laptops, SSH sessions, and CI runners; no localhost listener is required.

Confirm it worked:

Terminal window
kupe auth whoami

You should see your email, tenant, and plan.

Next

Section titled “Next”

Create your first cluster.

If you get stuck, see Support.