Skip to content
Zide Zide Zide

GitLab authentication

Zide connects to GitLab to provide issue tracking, merge requests, releases, pipelines, and other features.

You can authenticate Zide with OAuth, which is recommended, or a personal access token.

Authenticate with OAuth

To authenticate Zide with OAuth, complete the following steps.

  1. Open Settings.
  2. In Settings, click Git Accounts.
  3. In Git Accounts, click Connect account.
  4. In the Git hosting accounts dialog, click GitLab.
  5. In the Connect to GitLab dialog, copy the one-time code.
  6. Click Open in browser to open the GitLab verification page.
  7. In GitLab, enter the copied one-time code, then click Authorize
  8. Click Confirm.
  9. In Zide, click Done. Zide is now connected to your GitLab account.

Authenticate with a personal access token

To authenticate Zide with a personal access token, complete the following steps.

  1. Open Settings.
  2. In Settings, click Git Accounts.
  3. In Git Accounts, click Connect account.
  4. In the Connect a Git hosting account dialog, click GitLab.
  5. In the Connect to GitLab dialog, click Use Personal Access Token instead.
  6. In the Connect to GitLab with a Personal Access Token dialog, enter the base URL of your GitLab instance in the Instance URL field. The default URL is gitlab.com.
  7. In the Personal Access Token field, enter your personal access token. To generate a personal access token, see the Personal access tokens GitLab documentation.
  8. Click Done. Zide is now connected to your GitLab account.

Zide validates the token format and checks it against the GitLab API to confirm the token includes the required api, read_api scope.

Tokens

Tokens are stored securely in the native keychain of the following operating systems:

  • Windows: Data Protection API
  • macOS: Keychain
  • Linux: Secret Service (GNOME Keyring, KWallet, KeePassXC, or another libsecret provider)

Account metadata such as the username, avatar URL, and auth method is stored in Zide’s local SQLite database. Tokens remain in the operating system’s secure credential store.

OAuth tokens with expiration dates are refreshed automatically in the background. Personal access tokens do not expire unless they are revoked manually on GitLab.