GitLab

Create a dedicated service account for Gitar integration to maintain security and isolation:

1. Go to your GitLab instance admin area
2. Create a new service account with name "Gitar Service"
3. Grant appropriate permissions to repositories

Generate a Personal Access Token with the required scopes for the service account:

1. Log in as the service account
2. Go to User Settings → Access Tokens
3. Click "Add New Token"
4. Enter token name and set expiration

Select the following scopes for Gitar integration:

Required scopes:

• read_user - Required for user authentication and integration with Gitar
• read_repository - Allows Gitar to read repository contents, branches, and metadata
• read_api - Enables reading GitLab API data for project information and settings
• write_repository - Required for creating pull requests and pushing code changes
• api - Enables automatic webhook setup and project discovery

Click "Create personal access token" to generate the token. Save the generated token securely - you won't be able to see it again.

Before configuring the connection, you must add the service account as a member to each project that you want to enable with Gitar. The service account requires Maintainer role or higher.

1. Navigate to your GitLab project
2. Go to Settings → Members
3. Click "Invite members"
4. Search for your service account user
5. Assign Maintainer role or higher

Use the generated token to configure the connection with the following fields:

• GitLab Host: The hostname of your GitLab instance (e.g., gitlab.com, gitlab.example.com)
• Group/Namespace Path: The group or namespace path (e.g., "gitarcode" for gitlab.com/gitarcode)
• Project ID (Optional): Find your project ID in GitLab project settings
• Personal Access Token: Token needs all the scopes listed above