S
Updated 2026-07-19

Setting up your GitHub repository

Provision your org's isolated GitHub repository and get invited as an external collaborator, step by step.

Setting up your GitHub repository

Every SmixAI organization gets its own private GitHub repository, isolated from every other org. SmixAI hosts it inside the SmixAI GitHub organization and invites your GitHub user as an external collaborator on that one repository — so you get access to your code and nothing else.

You'll find the Repository card under Settings (admin only). It walks you through six steps, and each one verifies before you move on.

The six steps

  1. GitHub username — Enter the GitHub username of the person who will work on the repo. This is the account we invite as a collaborator, so it must be an existing GitHub account. If you don't have one yet, create a GitHub account first, then come back and enter the username.
  2. Check for an existing repository — SmixAI scans to see whether a repository already exists for your org. If one does, you can adopt it; if not, you'll create one in the next steps.
  3. Choose your repository — Pick one:
    • SmixAI-hosted private repo — we create a private repository for you.
    • I already have my own repo — enter it as owner/name and we'll point SmixAI at it instead (no invite needed, since you already own it).
  4. Set up the repository — Provision the SmixAI-hosted repo (idempotent — safe to re-run), or verify and designate the repo you supplied. When it's ready you'll see a link to it.
  5. Invite as external collaborator — SmixAI sends your GitHub user an invitation to the repo with maintain access. Accept it from the GitHub email (or the Open invitation link on the card), then click Verify acceptance. This step is skipped when you brought your own repo.
  6. All set — Once access is verified, the card turns green and the repository is ready for the code-fix and rollback flows.

Notes

  • The repository is private and lives inside the SmixAI GitHub organization. You are invited to only your repository — never to the organization itself — which is how tenants stay isolated.
  • New organizations get their repository automatically when the org is created; this card lets you create, adopt, or verify it on demand.
  • If you see a note that "the GitHub App isn't configured," collaborator invites are temporarily unavailable on this environment. Ask your SmixAI administrator to finish the GitHub App setup (GITHUB_APP_ID, GITHUB_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID).