Connect GitLab to a Project
GitLab is an open-source web-based git repository manager. You can link one repository per project. Different repositories can be linked to different components within the same project. The connection with GitLab is read-only, which means files added to your GitLab repository will be viewable - but not editable - via the OSF.
The GitLab add-on allows you to connect external content to OSF. This connection does not store or back up this content on OSF. To back up your content to OSF Storage, consider registering your project.
Enable GitLab in your project
First, open your project, then click the Add-ons tab in the navigation bar.
You will be taken to the "Add-ons" page for the project. Where you will select if you are looking for an “additional storage” add-on or a “citation manager” tool. In this case, you will select “additional storage” and then click “Connect” under GitLab
The Gitlab terms will appear. Read the terms, then click the Confirm button.
Setting up a new Gitlab Account
Because other contributors can connect their add-on accounts to a project you can distinguish your account with a different name. For example, naming your account “Your NAME_ADD-ON” Allows you to distinguish accounts from your collaborators. Once you have completed the “Setup New Account” Screen click “Connect”. You will need to provide the URL for gitlab: https://gitlab.com, along with an API token or Personal Access Token you generate in your Gitlab account profile.
Select which folder you would like to connect by using the select bubble for specific folders. Then click “save”. To include all folders leave bubbles unselected. Then click “save”
You have now connected your Add-on library to your OSF project and will be returned to the Add-on selection page. Your folder(s) will be connected to your project on the project file page.
