GitLab Setup
Connect your GitLab repositories to GitProductivity.
GitLab Setup
This guide walks you through connecting your GitLab repositories to GitProductivity.
Prerequisites
Before connecting GitLab, ensure you have:
- A GitLab account with repository access
- Developer or Maintainer permissions for the repositories you want to connect
- At least one existing repository
Connecting GitLab
Navigate to Integrations
Go to your dashboard and click Integrations in the sidebar, then select GitLab.
Authorize GitLab App
Click Connect GitLab to authorize our GitLab application. You'll be redirected to GitLab's authorization page.
Select Repositories
After authorization, choose which repositories to analyze. You can select individual projects or entire groups.
Configure Sync Settings
Set up your sync preferences:
- Include merge requests
- Sync commit history depth
- Exclude specific branches
Supported GitLab Versions
We support:
- GitLab.com (cloud)
- GitLab Self-Managed (self-hosted)
- GitLab Enterprise Edition
For self-hosted GitLab, you'll need to provide your instance URL during setup.
Permissions Required
Our GitLab integration requires these scopes:
| Scope | Purpose |
|-------|---------|
| read_api | Access API for repository data |
| read_repository | Read commit history and files |
| read_user | User identification |
Self-Managed Configuration
For GitLab Self-Managed instances:
Enter Instance URL
Provide your GitLab instance URL (e.g., https://gitlab.yourcompany.com)
Create Personal Access Token
In GitLab, create a personal access token with read_api and read_repository scopes.
Enter Token
Paste the token in the connection settings. We'll securely store and encrypt it.
Keep your access token secure. If compromised, revoke it immediately in GitLab settings.
Troubleshooting
Connection Failed
- Verify your instance URL is correct
- Ensure the access token has required scopes
- Check that your GitLab instance is accessible
No Projects Showing
- Verify you have projects with correct permissions
- Try syncing specific projects instead of groups
- Contact support for assistance
Next Steps
- Connect GitHub for additional integrations
- Configure the API for custom integrations
- Review your productivity metrics