Sign in to Gitea, Forgejo or Codeberg with an access token

For codeberg.org and your own Gitea or Forgejo server. A token is the way in for this build.

On this page

Steps

  1. 1
    In Repotray open Accounts, Add account, then Gitea · Forgejo · Codeberg.
  2. 2
    On Server address, type codeberg.org or the address of your server. When the FOUND card appears, tap Continue.
  3. 3
    The next screen says "This forge has not added Repotray yet". Under "Or use a personal access token", tap Use a personal access token.
  4. 4
    Tap Open token page. It opens the Applications page of your server's settings, where you create the token.
  5. 5
    Give the token the scopes listed below, then copy it.
  6. 6
    Back in Repotray, paste it into Token (or tap Paste) and tap Check token.

Scopes

The token form lists these under Minimum scopes. Give the token the matching permissions on your server.

ScopeWhat it covers
read:userYour profile
write:repositoryRepositories
write:issueIssues
write:notificationNotifications

Repotray checks the token before saving it by reading your profile, your repositories and your notifications. A token that is refused is not saved, and the form says "The forge rejected this token. Create a new token or check its scopes."

Saved token

After a successful check the token is stored on the phone and shown only as its last four characters.

Browser sign-in is not set up for Codeberg or for self-hosted servers in this build, so the token route above is the one to use. For a server with its own address or certificate, see the Self-hosted servers section.