Importing from GitHub

Prerequisites

• A GitHub account with access to the repositories you want to import
• A GitHub OAuth App registered under your GitHub account or organization (for UI imports)

Step 1 — Register a GitHub OAuth App

You only need to do this once.

1. Go to GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
2. Fill in:
   • Application name: GitBlixt (or whatever you'd like)
   • Homepage URL: https://git.yourdomain.com
   • Authorization callback URL: https://git.yourdomain.com/oauth/github/callback
3. Click Register application
4. Copy the Client ID and generate a Client Secret
5. Set these on your GitBlixt instance:

   GITHUB_CLIENT_ID=your-client-id
   GITHUB_CLIENT_SECRET=your-client-secret

   Then restart the container.

Step 2 — Connect Your GitHub Account

1. Go to your GitBlixt Dashboard and click Import Repository
2. Select GitHub
3. Click Connect GitHub — you'll be redirected to GitHub to authorize GitBlixt
4. After authorizing, you'll be returned to GitBlixt with your repositories listed

Step 3 — Select and Import

1. Browse or search your repositories
2. Check the boxes next to the repos you want to import
3. Click Import Selected
4. Watch the progress — each repository shows its import status in real time
5. When complete, your repositories appear in your GitBlixt dashboard

Importing Private Repositories

GitBlixt requests the repo scope during OAuth, which includes private repositories. If you only want to import public repositories, you can limit to public_repo scope by adjusting the GITHUB_OAUTH_SCOPE environment variable.

Scopes Requested

GitBlixt uses read-only access. It never writes to or modifies your GitHub repositories.