ℹ️ Requires a Professional or Team plan
Use GitHub, the most popular Git hosting platform, to store your project files in the cloud. The integration allows you to create repositories from Anchorpoint.
Limitations when adding members#
GitLab uses usernames instead of email addresses to identify their users. This makes it hard for Anchorpoint to match. If a username is totally different from the email address, Anchorpoint will not be able to add a user to a GitHub repository. So you have to add members manually on GitHub after you added them in Anchorpoint. However, if you members are creating a new GitHub account, make sure that the username is exactly the same as their email (without the @something.com). In this case, Anchorpoint will be able to match GitHub username and Anchorpoint email.
Create an organization on GitHub#
GitHub allows you to create repositories right after you create an account. To use the Anchorpoint integration, you must first create an organization on GitHub. This organization will correspond to an Anchorpoint workspace. All repositories created in Anchorpoint will be part of this GitHub organization.
Choose a GitHub organization
If the integration is active, you can create Git repositories directly from Anchorpoint. To do this, create a project in Anchorpoint and select the Git Repository option. Under Remote Settings, then select New GitHub Repository. In the next step, add the members. Anchorpoint tries to add them on GitHub if their username is similar to their email address. If Anchorpoint fails to do so, it will show an information, so that you can add them manually.
If you remove a project on Anchorpoint, it is not automatically removed from GitHub. You have to remove it manually there.
Anchorpoint cannot create a GitHub repository in an organization#
You need to allow access for the Anchorpoint OAuth app in your organization under https://github.com/organizations/YOUR-ORGANIZATION/settings/oauth_application_policy so that the OAuth app can act on behalf of the user inside your organization. After the first attempt to make changes in the organization via Anchorpoint, an entry will pop up on the given URL that someone with admin rights in the organization needs to accept.
User is not invited to GitHub organization#
Check if the organization is selected in integration settings. We cannot invite users to your personal GitHub because there is no concept of members there.
Check if a user invite is already created for the invited user under https://github.com/orgs/YOUR-ORGANIZATION/people/pending_invitations. If there is already a pending invite, maybe delete it and invite the user again from this page.
User is not removed from GitHub organization#
Anchorpoint will search for the user with their email in a GitHub organization. If the user has no public email or their username does not relate to the part of the email (e.g. username: johnhunt and email firstname.lastname@example.org), Anchorpoint will not find the organization member and the delete will fail. You can go to https://github.com/orgs/YOUR-ORGANIZATION/people and delete the user directly from Members or from Invitations.
User has no access to GitHub repository but was invited into the Anchorpoint project#
Anchorpoint cannot invite people into personal repositories, only into organization repositories. So check your integration settings if you have selected your organization.
Anchorpoint will search for organization members based on the Anchorpoint account email address of the user. If the user has no public email in GitHub or their username does not relate to the part of the email (e.g. username: johnhunt and email email@example.com), Anchorpoint will not find the organization member and the invite will fail. You can manually invite an organization member into a repo under https://github.com/YOUR-ORGANIZATION/PROJECT-NAME/settings/access.
User could not be removed from GitHub repository but was removed from Anchorpoint project#
Anchorpoint will search for organization members based on the Anchorpoint account email address of the user. If the user has no public email in GitHub or their username does not relate to the part of the email (e.g. username: johnhunt and email firstname.lastname@example.org), Anchorpoint will not find the organization member and the removal will fail. You can manually remove an organization member from a repo under https://github.com/YOUR-ORGANIZATION/PROJECT-NAME/settings/access.