Sign in to GitLab with an access token

For gitlab.com and self-hosted GitLab. Browser sign-in is not set up in this build, so a token is the way in.

On this page

Steps

  1. 1
    On GitLab, open Preferences, Access tokens.
  2. 2
    Create a token with the scopes api and read_user and an expiry date.
  3. 3
    In Repotray open Accounts, Add account, GitLab.
  4. 4
    On Server address, enter gitlab.com, or for a self-hosted server its address, for example https://gitlab.example.com. When the FOUND card appears, tap Continue.
  5. 5
    On "This forge has not added Repotray yet", tap Use a personal access token.
  6. 6
    Paste the token and tap Check token. It is stored in the phone's secure storage.

The token page

This address opens the GitLab token page with the name and scopes filled in:

Token page address
https://gitlab.com/-/user_settings/personal_access_tokens?name=Repotray&scopes=api,read_user

Scopes

ScopeWhat it is used for
apiRead and act on projects, reviews, runs and deployments
read_userShow the account's name and picture

Expiry

GitLab tokens must have an expiry date. Repotray says when the token is about to expire.

Repotray account switcher: all accounts on five forgesRepotray account switcher: all accounts on five forges
After sign-in the account appears in the account switcher.