GitLab Setup

Connecting GitLab to Oplane is straightforward — just log in with your GitLab account and you're ready to go. No app installation or extra permissions steps required.

Step 1: Log in with GitLab

In your Oplane dashboard, go to Settings in the sidebar, then Git, and click Link GitLab. You'll be redirected to GitLab where you log in with your existing account.

Oplane dashboard showing the GitLab connection settings

Once authenticated, Oplane automatically discovers your groups and projects — no manual configuration needed.

Permissions: Oplane requests read access to your repositories to analyse code and post review comments on merge requests.

Step 2: Choose Your Projects

After connecting, you'll see your GitLab projects listed in the Oplane dashboard. For each project, choose a review mode:

Review every MR

Oplane automatically runs a security review on every new merge request. Best for projects with active development.

On request only

Trigger a review manually when you need it. Good for projects where you want to review selectively.

Disabled

No security reviews for this project. Use this for projects you don't need to threat model.

That's It

Once connected, Oplane analyses merge requests for architectural security risks and posts findings as review comments — the same way it works with GitHub, just with a simpler setup process.

Tip: You can change the review mode for any project at any time from the Oplane dashboard.