# GitLab + Lutril: setup guide

> GitLab se connecte en OAuth. Pour une instance auto-hébergée, vous renseignez d’abord l’URL de base, puis vous autorisez l’application Lutril, qui demande les accès api et read_user pour lire vos utilisateurs et vos projets.

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

---

## Setup

1. Dans Lutril, ouvrez Paramètres → Intégrations et sélectionnez GitLab.
2. Pour une instance auto-hébergée, saisissez l’URL de base de votre GitLab (à ignorer pour gitlab.com), puis cliquez sur Connecter.
3. Vous êtes redirigé vers GitLab pour autoriser l’application Lutril avec les scopes api et read_user.
4. Cliquez sur Authorize ; GitLab vous redirige vers Lutril et la connexion est établie.
5. Vous pouvez sinon coller un jeton d’accès personnel disposant des scopes api et read_user dans le champ manuel.

## Access requested

- api (accès API en lecture et écriture)
- read_user (lire le profil de l’utilisateur authentifié)

## References

- [GitLab documentation](https://docs.gitlab.com/user/profile/personal_access_tokens/)
- [GitLab console](https://gitlab.com/-/user_settings/personal_access_tokens)
- [Référence des scopes de jeton d’accès](undefined)
