GitLab Integration
This guide walks you through the process of installing OpenHands Cloud for your GitLab repositories. Once set up, it will allow OpenHands to work with your GitLab repository.
Prerequisites
- Signed in to OpenHands Cloud with a GitLab account.
Adding GitLab Repository Access
Upon signing into OpenHands Cloud with a GitLab account, OpenHands will have access to your repositories.
Working With GitLab Repos in Openhands Cloud
After signing in with a Gitlab account, use the select a repo and select a branch dropdowns to select the
appropriate repository and branch you’d like OpenHands to work on. Then click on Launch to start the conversation!
Using Tokens with Reduced Scopes
OpenHands requests an API-scoped token during OAuth authentication. By default, this token is provided to the agent.
To restrict the agent’s permissions, you can define a custom secret GITLAB_TOKEN, which will override the default token assigned to the agent.
While the high-permission API token is still requested and used for other components of the application (e.g. opening merge requests), the agent will not have access to it.
Next Steps
- Learn about the Cloud UI.
- Use the Cloud API to programmatically interact with OpenHands.