ConnectorsSetup guides
GitLab
Project files, and optionally issues.
What it brings in
Project files, and optionally issues.
Credentials
A personal access token with read_api and read_repository. GitLab → Preferences → Access tokens. Set the base URL if self-managed.
Settings
| Setting | What it is |
|---|---|
api_token | API token |
base_url | Base URL of your instance |
include_extensions | File extensions to include |
projects | Projects to sync |
sync_issues | Also sync issues |
Adding it
- Connectors → Add connector → GitLab
- Decide global or personal — this is the one choice that is awkward to change later
- Enter the credentials above
- Narrow the scope before the first sync
- Save. Syncing starts immediately
Nothing is searchable until the first sync finishes. Progress is on the connector page.
If it fails
The connector page shows the error. The usual causes are an expired credential, a permission changed on the far side, or — for GitLab — access not having been granted to the specific content yet.