# GitLab + Lutril: setup guide

> GitLab connects through OAuth. For self-managed instances you set the base URL first, then authorize the Lutril app, which requests api and read_user access to read your users and projects.

Source: https://www.lutril.com/integrations/gitlab
Category: Developer tools
Auth: oauth
Last verified: 2026-06-17

---

## Setup

1. In Lutril, open Settings → Integrations and select GitLab.
2. For a self-managed instance, enter your GitLab base URL (skip for gitlab.com), then click Connect.
3. You are redirected to GitLab to authorize the Lutril app with the api and read_user scopes.
4. Click Authorize; GitLab redirects you back to Lutril and the connection is established.
5. Alternatively, paste a personal access token with the api and read_user scopes into the manual field.

## Access requested

- api (read and write API access)
- read_user (read the authenticated user’s profile)

## References

- [GitLab documentation](https://docs.gitlab.com/user/profile/personal_access_tokens/)
- [GitLab console](https://gitlab.com/-/user_settings/personal_access_tokens)
- [Access token scopes reference](https://docs.gitlab.com/security/tokens/access_token_scopes/)