Importing from GitLab.com

Prerequisites

• A GitLab.com account with access to the repositories you want to import
• A GitLab OAuth Application registered in your GitLab account settings

Step 1 — Register a GitLab OAuth Application

1. Go to GitLab.com → User Settings → Applications
2. Fill in:
   • Name: GitBlixt
   • Redirect URI: https://git.yourdomain.com/oauth/gitlab/callback
   • Scopes: check read_user, read_api, read_repository
   • Leave Confidential checked
3. Click Save application
4. Copy the Application ID and Secret
5. Set these on your GitBlixt instance:

   GITLAB_CLIENT_ID=your-application-id
   GITLAB_CLIENT_SECRET=your-secret

   Then restart the container.

Step 2 — Connect Your GitLab Account

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

Step 3 — Select and Import

1. Browse or search your projects
2. Select the ones you want to import
3. Click Import Selected and watch the progress

Scopes Requested

GitBlixt requests read-only scopes and never modifies your GitLab projects.

Token Expiry Note

GitLab OAuth tokens expire after 2 hours. GitBlixt automatically refreshes your token in the background. If your import session lasts longer than 2 hours, reconnect via Settings → Connected Accounts if you see an authentication error.