Repository navigation
Configuring GitHub & GitLab Tokens
By default, ApkUp accesses public developer repositories on GitHub, GitLab, and Codeberg / Forgejo anonymously. However, for active users, private repositories, or hosts with strict rate limits, adding your own Personal Access Token (PAT) provides maximum reliability.
- 1. Why Do I Need an Access Token?
- 2. How to Generate a GitHub Personal Access Token
- 3. How to Generate a GitLab Personal Access Token
- 4. How to Generate a Codeberg / Forgejo Access Token
- 5. Adding and Testing Tokens in ApkUp
- 6. Multi-Level GitLab Subgroups (
group/subgroup/project) - 7. Privacy & Security FAQ
GitHub strictly restricts anonymous API requests to 60 requests per hour per public IP address.
- If you track 15–20 apps hosted on GitHub, checking for updates twice quickly exhausts this quota.
- If you use a VPN or public Wi-Fi, other users sharing that IP also consume your quota, leading to immediate
HTTP 403 API rate limit exceedederrors. - Adding a free GitHub Personal Access Token raises your limit immediately to 5,000 requests per hour and enables batched GitHub GraphQL queries (checking up to 20 repositories in a single API call instead of one REST request per app).
While public GitLab projects can often be browsed anonymously, many developers and organizations host repositories under multi-level subgroups or private team workspaces. A GitLab token ensures ApkUp can query release tags and asset URLs reliably.
You can generate a free token in less than 2 minutes:
- Sign in to your account at github.com.
- Click your profile avatar in the top right corner and open Settings.
- In the left sidebar, scroll to the bottom and click Developer settings.
- Select Personal access tokens ➔ Tokens (classic) (or Fine-grained tokens).
- Click Generate new token (classic):
-
Note: Enter a recognizable name (e.g.,
ApkUp-Updater). - Expiration: Select No expiration (or 90/365 days if preferred).
-
Scopes: For public repositories, no scopes are required (leave all checkboxes unchecked). If you want to track your own private repositories, check
repo.
-
Note: Enter a recognizable name (e.g.,
- Click Generate token at the bottom of the page.
-
Important: Copy the generated token string (
ghp_xxxxxxxxxxxxxxxxxxxx) immediately. GitHub will never display it again.
- Sign in to your account at gitlab.com (or your self-hosted GitLab instance).
- Click your avatar in the left sidebar and select Edit profile.
- In the left navigation, select Access Tokens.
- Click Add new token:
-
Token name:
ApkUp-Updater - Expiration date: Choose an expiration date.
-
Select scopes: Check
read_api(grants read-only access to repository releases and package assets).
-
Token name:
- Click Create personal access token and copy the token (
glpat-xxxxxxxxxxxxxxxxxxxx).
Starting with v1.43.0+, ApkUp supports Codeberg (codeberg.org) and self-hosted Forgejo instances via the v1 Releases REST API:
- Sign in to your account at codeberg.org (or open Create token on Codeberg directly from ApkUp's Codeberg bottom sheet).
- Navigate to Settings ➔ Applications (
https://codeberg.org/user/settings/applications). - Under Generate New Token, enter a name (e.g.,
ApkUp-Updater). - Select minimal read permissions (
read:repositoryfor private repos; public repos require no extra scopes). - Click Generate Token and copy the resulting string into ApkUp.
ApkUp includes a built-in token validator in unified Setup bottom sheets:
- Open ApkUp on your device and go to the Setup tab.
- Enable GitHub, GitLab, or Codeberg and tap the row to open its bottom sheet.
- Paste your personal access token into the input field.
- Tap Test Token to verify connectivity and inspect remaining API quotas directly before saving.
- Tap Save. Your token is active immediately for both manual and background checks.
Starting in ApkUp v1.40.1+, the GitLab repository resolver supports arbitrary nested subgroup paths.
When linking an app to a GitLab project, you can now enter:
- Standard project:
developer/app-name - Subgroup project:
organization/category/app-name - Multi-level hierarchy:
enterprise/division/team/mobile/app-name
ApkUp automatically URL-encodes nested subgroup slugs (enterprise%2Fdivision%2Fteam%2Fmobile%2Fapp-name) when querying GitLab REST API v4 endpoints, ensuring releases are fetched accurately without manual configuration.
Your tokens are stored exclusively on your device in Android's private, sandbox-isolated application storage encrypted at rest via Google Tink (AES-256-GCM) backed by the Android Keystore (SecurePrefsStore), with cloud backup disabled (allowBackup="false").
Never. ApkUp enforces strict host isolation: your GitHub token is sent exclusively to api.github.com, your GitLab token exclusively to gitlab.com, and your Codeberg token exclusively to codeberg.org / *.codeberg.org over HTTPS (tokens are stripped automatically on cross-host redirects and are never sent to third-party custom domains). There are no intermediate telemetry, analytics, or proxy servers.
Yes, at any time. Simply visit your GitHub, GitLab, or Codeberg token management settings and click Revoke or Delete.