Skip to content

GitHub and GitLab API Tokens

DavidoTek edited this page Mar 30, 2025 · 2 revisions

ProtonUp-Qt uses the GitHub API. If the API is used too much it can happen that it won't load new releases. In that case you have to wait a few hours and it should work again. Alternatively, you can setup a GitHub or GitLab API token.

You can check if the API is working for you by clicking following link, it should show a list of URLs: https://api.github.com/repos/GloriousEggroll/proton-ge-custom/releases

Generating access tokens

Configure tokens using the GUI (only v2.12.0 and newer)

Follow these steps to configure the API access tokens from the graphical interface. This is supported in version 2.12.0 and newer.

  1. Open the About dialog by clicking About in the main window
  2. Enable advanced mode
  3. Select Edit Git access tokens
  4. Enter the GitHub and/or GitLab access token into the fields
  5. Press Save

grafik

Config file (only for v2.9.0 and newer)

In ProtonUp-Qt version 2.9.0 and newer, it is also possible to configure the tokens in ProtonUp-Qt's configuration file without requiring environment variables. A GUI option will follow.

You can find the configuration file under ~/.var/app/net.davidotek.pupgui2/config/pupgui/config.ini (installed from app store) or ~/.config/pupgui/config.ini (AppImage from GitHub).

Append the following lines to the config file or edit them if they already exist:

github_api_token = your-GitHub.com-token-here
gitlab_api_token = your-GitLab.com-token-here

You may, but don't have to configure both a GitHub and a GitLab token.

NOTE: If the environment variables are set, they will override the tokens configured in the config file!

Specifying the access token from the command line

Furthermore, it is possible to specify the access tokens using the command line:

PUPGUI_GHA_TOKEN=token_here flatpak run net.davidotek.pupgui2
PUPGUI_GLA_TOKEN=token_here flatpak run net.davidotek.pupgui2
Clone this wiki locally