Common problems with GitHub

When you add the integration

What you see	What to do
Under the Token field: Token is required.	The field is empty; nothing was sent to GitHub. Paste the token.
api.github.com refused the credentials (401). Check the token, and that it has not expired. Fix the field above, or save anyway if the source is only unreachable for now.	The token is wrong, revoked or expired. Paste the token alone (it starts with ghp_), or create a new one.
No server answers to the name <host>. Check its spelling against the address you open in your browser. If it is right, Astrolabe cannot see this server: tell your company's Astrolabe administrator. Fix the field above, or save anyway if the source is only unreachable for now.	Copy the domain name from the address bar of your GitHub, without https:// nor path. If it is right, the server is not reachable from Astrolabe.
The card says Set by app-config.local.yaml (or another file name), and the page says This connection is set by the config file app-config.local.yaml: a token added here would be ignored. Change it in that file, or ask whoever manages the instance's files. Add Token is greyed out.	A configuration file of the instance declares GitHub, and a file always wins over the administration. Change the token in that file, or ask whoever manages the instance's files to remove GitHub from it: the administration then takes over.

On the component page

What you see	What to do
No GitHub tab	Add the github.com/project-slug annotation (Show the GitHub tab), and check that GitHub is on in Administration › Plugins.
In the tab or the GitHub releases card: The repository <owner>/<repository> cannot be reached with your GitHub token: check the github.com/project-slug annotation, or the token access.	No repository has that name, or the token's account cannot see it. Compare the annotation with the repository's address on GitHub, then check that the token's account has access to it.

On your dashboard

What you see	What to do
The github source is missing from Add a card	The GitHub integration is not configured. Add it.
Your GitHub account is not connected.	Click Connect my GitHub account in the card. See Connect your GitHub account.
Nothing here yet and No open pull request in the GitHub repositories named by the components of the catalog (github.com/project-slug annotation) that your token can read.	Check that the repository is named by a component of the catalog (github.com/project-slug), that your token can read it, and the card's organizations field.
The Pull Requests card is empty after you removed values in Filters	The filter keeps no row. Open Edit on the card, then Filters, and click Reset under the column.
List cut: too many items to read, only the most recent are shown. above the table	GitHub holds more than the card can read: the rows shown are the most recent ones.
Nothing here yet and No workflow run lately in the GitHub repositories of the components you own (github.com/project-slug annotation).	Check that you own the component of the repository and that it carries the github.com/project-slug annotation.
Nothing here yet and No release published in the GitHub repositories named by the components of the catalog (github.com/project-slug annotation) that your token can read.	Check that the repository is named by a component (github.com/project-slug) and that your token can read it.
GitHub refused the token. The token may have expired or been revoked: replace it in Administration › Company connections › GitHub (or in My account › My accounts if it is your own).	Your token is revoked, expired or wrong. Click Open the GitHub integration, or go to My Account › My accounts, click Configure, then Replace next to Token, paste a new token, Save.
In My Account › My accounts, the GitHub card says Token refused	GitHub refuses your token: revoked, expired, or without the rights. Click Configure: the form says why. Click Replace next to Token, paste a new token, Save.
Test Connection in Connect my GitHub account says api.github.com refused your token (401). Check it, and that it has not expired.	Your token is wrong, revoked or expired. Paste a valid token of your own GitHub account.

When the tab says a module is missing

What you see	What to do
Astrolabe does not offer this GitHub feature on this instance. and A module is missing from this Astrolabe installation. Tell your Astrolabe administrator.	The integration may be connected and the plugin on, but this installation of Astrolabe lacks the module that serves GitHub. Tell your Astrolabe administrator. Nothing to change on the component.

Not verified on an instance yet: this message needs an installation that lacks the module.

Still stuck?

Write to support@forgeit.fr with the name of the component and its GitHub repository.