Setting up the Integration

Add Git Credentials

In order to use the Git integration, you must first add credentials to your Account page in Code Ocean.

1. Click the Account icon

2. From the Credentials screen click + Add Credentials

3. Click <Git provider> Credentials

   
4. Enter your Git provider's username and a Personal Access Token (PAT). Click the developer settings link to visit the webpage where a PAT can be generated. See below for more information.

   

If <Git provider> Credentials isn't an option under + Add Credentials, please ask your Code Ocean admin to configure Git provider integration from the Admin Dashboard.

Generate a Personal Access Token (PAT) for Code Ocean

Follow the steps below to generate a PAT in your Git provider's account. Note that the exact process varies depending on the Git provider, but the objective is to retrieve the token from the Git provider and add the token to your Code Ocean account.

GitHub

Creating a GitHub Personal Access Token

1. In the upper-right corner of the page, click your profile photo, then click Settings.

2. In the left sidebar, click Developer settings.

3. In the left sidebar, click Personal access tokens, select Tokens (classic).

4. Click Generate new token, select Generate new token (classic).

5. Fill out the form and check the repo box for the scope.

For more information about how to generate a GitHub PAT, read this article from GitHub.

GitLab

Bitbucket

Azure DevOps

Note: If the email address you used to create your Code Ocean account does not match the email address associated with the GitHub account you've linked, commits will appear in GitHub as being created by a generic user with your Code Ocean user name. If you'd like commits from Code Ocean to appear in GitHub as being created by your linked GitHub account, you can simply add the email address used to create your Code Ocean account as an additional email address in your GitHub account by following this guide from GitHub.