> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/hybrid-hivel-agent/5.-configuration-reference/gitlab-settings-gitlab.md).

# GitLab settings (gitlab: )

GitLab is also a list, so multiple instances (e.g. gitlab.com plus a self-hosted instance) are supported side by side. The settings below cover connection and auth, which groups/projects/branches to include or exclude, performance tuning, and privacy controls.

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Required</strong></td><td><strong>Default</strong></td><td><strong>Description</strong></td></tr><tr><td>instance_slug</td><td>Yes</td><td>-</td><td>Unique name for this instance</td></tr><tr><td>token</td><td>Yes (self-hosted)</td><td>-</td><td>GitLab Personal Access Token - must be a user PAT, not a group access token. Omit for Hivel-managed credentials - see Hivel-managed credentials below</td></tr><tr><td>url</td><td>No</td><td>https://gitlab.com</td><td>Override for self-hosted instances</td></tr><tr><td>earliest_data_date</td><td>Yes</td><td>-</td><td>YYYY-MM-DD</td></tr><tr><td>include_groups</td><td>No</td><td>all accessible</td><td>Group paths to sync</td></tr><tr><td>exclude_groups</td><td>No</td><td>-</td><td>Group paths to skip</td></tr><tr><td>include_projects</td><td>No</td><td>all</td><td>Project paths to sync</td></tr><tr><td>exclude_projects</td><td>No</td><td>-</td><td>Project paths to skip</td></tr><tr><td>extra_branches</td><td>No</td><td>-</td><td>Additional branches to fetch</td></tr><tr><td>concurrent_threads</td><td>No</td><td>5</td><td>Goroutines for concurrent project fetching</td></tr><tr><td>skip_ssl_verification</td><td>No</td><td>false</td><td>Disable TLS (self-signed certs on self-hosted)</td></tr><tr><td>exclude_commit_patterns</td><td>No</td><td>-</td><td>Glob patterns for commit messages to skip</td></tr><tr><td>exclude_pr_source_branches</td><td>No</td><td>-</td><td>Glob patterns for MR source branch</td></tr><tr><td>exclude_pr_target_branches</td><td>No</td><td>-</td><td>Glob patterns for MR target branch</td></tr><tr><td>exclude_file_paths</td><td>No</td><td>-</td><td>Glob patterns for file paths in MRs</td></tr><tr><td>redact_names_and_urls</td><td>No</td><td>false</td><td>Redact names and URLs</td></tr><tr><td>strip_text_content</td><td>No</td><td>false</td><td>Strip all text content</td></tr></tbody></table>

**Multi-instance credentials** - use a different ${ENV\_VAR} per entry (same pattern as GitHub above):

```
gitlab:
  - instance_slug: gitlab-cloud
    token: ${GL_CLOUD_TOKEN}
  - instance_slug: gitlab-server
    token: ${GL_SERVER_TOKEN}
    url: ${GL_SERVER_URL}
    skip_ssl_verification: true
```

{% columns %}
{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/github-settings-github.md" class="button primary" data-icon="backward">GitHub settings</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/hybrid-hivel-agent/5.-configuration-reference/bitbucket-settings-bitbucket.md" class="button primary" data-icon="forward">BitBucket settings</a>
{% endcolumn %}
{% endcolumns %}