GitLab (self-hosted)#

ℹ️ Requires a Professional or Team plan

The self-hosted version of GitLab offers the same features as the cloud version of GitLab, but with more control. This is particularly useful for configuring Git LFS.

Requirements#

For a self-hosted GitLab instance, users are identified by their email addresses during the invitation process. When adding members to GitLab, ensure that their email address is valid and corresponds to the same email address used in Anchorpoint. For instance, if a user’s email is “catherine.brown@gmail.com”, this same email should be used in both GitLab and Anchorpoint. If you wish to utilize email invitations for your self-hosted GitLab instance, you must correctly configure the GitLab SMTP settings.

In instances where public user signup is disabled, it’s important to note that users invited via email must first be created by a GitLab administrator. For more information on this, refer to the GitLab documentation on user creation.

Troubleshooting#

I cannot choose the group I want to use with Anchorpoint when connecting to Gitlab#

Anchorpoint filters available groups for an access level of at least “maintainer” to allow inviting additional members to the group. So please check if you have the necessary access level to the group in Gitlab.

I cannot create a Gitlab project in a group when creating a project in Anchorpoint#

You need at least “maintainer” access level in the group to create new projects. Please check if you have the necessary access level in the group.

User is not removed from Gitlab group when removing from Anchorpoint workspace#

Anchorpoint will search for the user with their email in Gitlab. 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: johnhunt@anchorpoint.app), Anchorpoint will not find the group member and the deletion will fail. You can go to GITLAB-SERVER-URL/groups/GROUP-NAME/-/group_members and delete the user directly from “Members” or “Invitations”.

User could not be removed from Gitlab project, but was removed from Anchorpoint project#

Anchorpoint will search for members based on the Anchorpoint account email address of the user. If the user has no public email in Gitlab or their username does not relate to the part of the email (e.g. username: johnhunt and email: johnhunt@anchorpoint.app), Anchorpoint will not find the organization member and the removal will fail. You can manually remove a member from a project under GITLAB-SERVER-URL/GROUP_NAME_OR_USERNAME/PROJECT_NAME/-/project_members.