OSF GuidesAdd-ons Help GuidesConnect to a GitHub Organization

Connect to a GitHub Organization

This help guide will walk you through how to connect repositories included in your organizations to your OSF projects.

Only one repository can be connected per project. To connect more, we recommend creating components and connecting other repositories that way. 

1. Revoke access to OSF from GitHub

If GitHub is not already connected to your OSF projects, skip this step and start with Step 2: Authorize GitHub as an add-on.

If Github is connected to your OSF projects, you will need to revoke access to OSF from your GitHub account before you can connect organizations to your projects.

First, sign in to your GitHub account.

Click your profile in the top right of the page, then click Settings from the drop-down menu.

Your "Personal settings" page will appear.

Click Applications from the left sidebar.

You'll be taken to the "Applications" page.

Click the Authorized OAuth Apps tab.

Then, find OSF in the list and click the Revoke button.

2. Authorize GitHub as an add-on

Sign in to OSF.

Click your name in the top right, then click Settings from the drop-down menu.

Your user "Settings" page will appear.

Click Configure add-on accounts in the left sidebar.

A list of add-ons will appear.

Find GitHub in the list, then click the Connect or Reauthorize Account link.

3. Grant or request access to an organization

You'll be taken to the "OAuth" page for GitHub.

Find the "Organization access" section, and click Grant (if you're an owner of the organization) or Request (if you're a member of the organization).

Then click the green Authorize CenterForOpenScience button.

4. Connect GitHub to your project

Next, open your OSF project.

Connect and configure Github (see the Connect Add-Ons help guide).

Then select an organizational repository from the list, and click Save.

The organizational repository will be connected to your project.