Setup
Start connection
Click Connect on GitLab Self-Managed. You will be redirected to GitLab to authorize the Blitzy application.
Granting Repository Access
- Navigate to Preferences > User Settings > Applications in your GitLab instance
- Click Add new application at the top right corner of Your applications
- Fill out your Name and the Redirect URI:
- Select the GitLab configuration
- Click Save
Permissions
The Blitzy GitLab App requires the following permissions, scoped to the minimum level needed.| Permission | Access Level | Purpose |
|---|---|---|
api | Read & Write | Access groups, projects, container registry, dependency proxies, and package registry |
read_api | Read | Read groups, projects, and registries |
write_repository | Write | Create branches and push generated code |
read_user | Read | Retrieve user identity for pull request attribution |
Permission Mapping Reference
| Operation | Required Scope | GitLab API |
|---|---|---|
| Clone repository | read_api | Repositories API |
| Create branch | write_repository | Branches API |
| Push commits | write_repository | Commits API |
| Create merge request | api | Merge Requests API |
| List projects | read_api | Projects API |
| Read user identity | read_user | Users API |
Organization Repositories
Organization admins must install and approve the Blitzy GitLab App:- Verify you have admin access to the organization
- Install the app (organization owners may need to approve)
- Team members can then connect their accounts to access authorized repositories