Your tenant

Every Kapacitor customer gets a managed instance at https://<your-github-org>.kapacitor.ai. This page is for the admin doing the one-time setup — installing the GitHub App and confirming your team can sign in. Individual contributors can skip ahead to Install the CLI.

1. You receive a tenant URL

Kurrent provisions your tenant and sends you a URL of the form:

https://acme.kapacitor.ai

…where acme is your GitHub org login. Until the GitHub App is installed, the tenant exists but no one can sign in.

2. Install the GitHub App

Open the public listing and click Install:

https://github.com/apps/kurrent-kapacitor

Select the org that matches your tenant subdomain. You can grant access to all repositories or to a specific subset; either is fine — Kapacitor only reads metadata (repo name, default branch, PR title) and never modifies your code.

The install grants Kapacitor:

• Read-only repository metadata for repos you select
• Read access to organization members and teams so the share picker can target real people
• Read access to pull requests so kapacitor review can correlate sessions to PRs

There is no per-tenant client secret to copy. The GitHub App is shared across all Kurrent-hosted tenants and the auth proxy holds the credentials; you only authorise the install.

3. Sign in

Open your tenant URL. You’ll be redirected to GitHub to authorise the OAuth flow:

https://acme.kapacitor.ai

Anyone in the org you authorised in step 2 can sign in. There is no separate user provisioning step — membership in the GitHub org is the gate.

4. Admins are auto-detected

GitHub org owners (role: admin in your org membership) are automatically Kapacitor admins. They see a Server Settings item in the user menu and can configure runtime settings (eval runner credentials, embedding provider, Slack integration) at /admin/settings.

If your GitHub user isn’t an org owner but should be a Kapacitor admin (break-glass), ask Kurrent to add your GitHub numeric ID to the tenant’s Auth:Admin:GitHubIds list.

5. Optional: install Slack link previews

If you want session links posted into Slack to expand into a card showing repo, summary, and ownership, follow the in-app wizard at /admin/slack. The whole flow takes about 90 seconds: it generates a Slack app manifest pre-filled for your tenant, you create an app from it in your Slack workspace, click Install to <Workspace> in OAuth & Permissions so Slack issues a bot token, then paste the Signing Secret and Bot User OAuth Token back into the wizard. See the Slack admin walkthrough for the detailed step-by-step.

Slack is optional. Skip it now; come back later.

What’s next

You’re done. Teammates don’t need the tenant URL to sign in — once a member of your GitHub org runs kapacitor setup, the CLI discovers your tenant automatically. Point them at Install the CLI.