Skip to main content

GitLab Configuration

Generate a Personal Access Token for GitLab and configure it in RoostGPT.

GitLab Cloud (gitlab.com)

Quick Token Generation

Use this direct link to go straight to the token creation page:

Generate GitLab token →

Manual Steps

  1. Go to GitLab → Settings → Access Tokens

    GitLab Access Tokens

  2. Enter a token name and expiration date

  3. Select the required scopes (see below)

  4. Click "Create token"

  5. Copy the token immediately — it is shown only once

Required Scopes

ScopePurpose
apiComplete API access
read_repositoryRead repository content
write_repositoryWrite repository content
read_userRead user information
read_apiRead API information

GitLab Self-Hosted

  • Token Type: Personal Access Token
  • Generation Steps: Same as GitLab Cloud but on your self-hosted instance
  • Base URL: Configure your GitLab instance URL (e.g., https://gitlab.yourcompany.com)

Add to RoostGPT

Web UI (Connector)

  1. Click Connectors in the top navigation bar → Code Repositories
  2. Select GitLab
  3. Enter your Personal Access Token
  4. For self-hosted instances, also enter your Base URL

CLI (.env file)

GIT_TYPE=gitlab
SOURCE_GIT_TOKEN=glpat-...your_token...
SOURCE_OWNER_NAME=your-group-or-username
SOURCE_REPO_NAME=your-repo
SOURCE_REPO_ID=12345678
SOURCE_BASE_BRANCH=main

# For self-hosted:
HOSTED_TYPE=hosted
GIT_HOSTED_URL=https://gitlab.yourcompany.com