Additional GitHub credentials
This article explains how to prepare and add additional GitHub and GitHub Enterprise credentials to Xopero ONE in order to prevent throttling.
GitHub account preparation
You can add anyone to your GitHub (or GitHub Enterprise) organization, and they will become a member. To do this, follow the instructions on the official GitHub page.
Personal access token preparation
To create a personal access token in GitHub:
In the upper-right corner of any page, click your profile photo and select Settings.
In the left sidebar, click Developer settings.
Select Personal access tokens.
Click Generate new token.
Enter a descriptive name for the token.
You must use tokens (classic)— Xopero ONE does not support fine-grained tokens. This may change once fine-grained tokens are out of beta.
Please note that the beta version may have changed. After the full release, our administrators will need time to analyze the possibility of supporting this token type.
Adding GitHub credentials to Xopero ONE
Adding additional credentials in Xopero ONE does not automatically integrate them into backup tasks— you must enable new credentials for use in a backup plan.
Login to , open the GitHub tab and click Edit in the bottom-left corner of your GitHub organization tile.
Go to the Throttling prevention section and click Manage credentials.
Click the Add new button and select one of the available options:
For Access Token:
Enter your account username and add or select PAT from the Password Manager, then confirm your selection. You can add any number of accounts to your organization.
We use a specific user and their limits, which is why a dedicated backup user is recommended. This prevents situations where real users might hit their API limits.
For GitHub App:
From the drop-down list, select an application (#1–#10) and install it in the appropriate organization. The process is the same as when adding the main GitHub app.
IMPORTANT! You can add an additional GitHub App only if the following conditions are met:
The installing account has sufficient permissions on GitHub— the installation must not require sending and approving an installation request (it may happen, for example, when the account lacks repository administration rights or has a role other than Owner in an organization). For more details, see Installing a GitHub App from a third party – GitHub Docs*.
The organization in Xopero system has the main credentials for the GitHub account where the additional GitHub App is being installed**:
If the organization was registered through a GitHub App, additional GitHub Apps can only be added for accounts that already have the main GitHub App registered. Additional GitHub App for other personal accounts are not allowed.
If the organization was registered through OAuth or a PAT, additional GitHub App can be added for any account, including other personal accounts.
*If condition 1 is not met, an error message will indicate that you do not have the required permissions to complete the installation.
**If condition 2 is not met, an error message will prompt you to first register the account with the organization in our system.
Enabling GitHub credentials for backup
In , open the Plans tab and click Add plan, or select Edit plan if you already have one.
Scroll down to Advanced settings, click Edit, and enable the Additional git credentials switch.
The system will display all additional accounts available for the selected organization. Toggle the switch ON next to the accounts you want to use, and then click the Save button.
Back in the Edit backup plan panel, click the Save button to save your backup plan settings. The backup plan will now run using the selected additional GitHub (or GitHub Enterprise) accounts.
Last updated