Skip to main content
GitLab support uses a deployment-owned token. There is no self-serve GitLab App or OAuth installation flow yet, so an operator provides a GitLab token, syncs repositories from Settings, and configures webhooks when review automation is needed. Use <public-url> below for your stable public Roomote URL.

​
Create a GitLab bot token

Create a dedicated GitLab bot or service-account user and add it to the groups or projects Roomote should access. Create an access token for that identity with scopes that match the behavior you want:
ScopeNeeded for
apiproject listing and repository sync through REST
read_repositorycloning private repositories over Git-over-HTTPS
write_repositorypushing branches or commits from Roomote tasks
Save the token in setup, deployment env vars, or local .env.local: 
GITLAB_TOKEN=<gitlab-token>
For self-managed GitLab, also set GITLAB_BASE_URL.

​
Sync repositories

After the token is available, open Settings, go to the Environments page, and use the Source Control section’s GitLab sync button. Roomote lists the GitLab projects visible to the token and stores them as GitLab repository rows. GitLab-backed tasks clone from the synced repository row, so sync must run before launching a GitLab-backed task.

​
Configure webhooks

Create a GitLab project or group webhook for merge request events. Webhook URL: 
<public-url>/api/webhooks/gitlab
Enable:
  • Merge request events
Preferred verification uses GitLab signed webhook headers. Set a GitLab signing token on the webhook and save the same value in Roomote: 
GITLAB_WEBHOOK_SIGNING_TOKEN=<signing-token>
Legacy secret-token verification is also supported: 
GITLAB_WEBHOOK_SECRET=<legacy-secret-token>

​
Enable review automation

GitLab merge-request reviews use the same Review Code automation targeting model as GitHub. After syncing repositories, associate the GitLab repository with the intended environment and enable Review Code automation for that target. Open or reopened merge request events enqueue initial review tasks. Update events enqueue sync reviews when GitLab includes oldrev, which indicates a code-related update.

​
Verify setup

  1. sync GitLab repositories from Settings
  2. create or update an environment from a synced repository
  3. start a small task and confirm Roomote can clone the repository
  4. open or update a merge request and confirm configured review automation runs