Storage Add-Ons

The OSF acts as a central hub to streamline your workflow by connecting to several third-party storage services. This article describes each storage add-on and how the connections work. For a description of how to enable these connections, see the Connect Add-ons article.

If you run into errors connecting an add-on to your project, check our status page for updates on how the OSF and add-on providers are operating.

If you are connecting to an institutional storage provider, and you receive a "permission denied error," the institution may need to add the OSF as an authorized application in order for us to connect to them. If this happens, please contact support@osf.io

Amazon S3

To connect Amazon S3 to an OSF account via the user settings page, the user must enter their Access Key and Secret Key. Empty fields for each are available below the Amazon S3 title.

Amazon S3 appears in in the file tree as an item in the component to which it has been added. It is on the same level as OSF Storage. The tree identifies the project:

Amazon S3: [bucket name]

File names from an Amazon S3 bucket are shown in the file tree on the OSF, available both in the Files Widget and the Files Browser.

Selecting the Amazon S3 add-on in the file tree shows a “Download as zip” button in the toolbar. Clicking downloads the entire contents of the bucket as a zip folder. Files from other storage add-ons can be moved into Amazon S3 by dragging and dropping. Files from Amazon S3 can be moved into other add-ons as well.

Amazon S3 Bucket Locations

When you create an Amazon S3 Bucket, you can choose its physical location in the world. You might do this to minimize latency or meet funder requirements about where your data can be stored.  

Bucket Locations
Frankfurt
Ireland
California
Oregon
Tokyo
Seoul
Singapore
Sydney
Sao Paulo
Bitbucket

Bitbucket is a web-based Git and Mercurial repository that allows you and your team members to store code. You can connect one Bitbucket repository to your OSF project. Different repositories can be linked to different components within the same project.

Files added to your Bitbucket repository will be accessible via the OSF.

Box

You can connect one Box folder or an entire Box account to your OSF project or component. Different Box folders can be linked to different components within the same project.

After linking a Box folder to an OSF project, its contents will be displayed in the Files Widget and the Files Browser. You can add files to your Box folder and those files will be accessible via the OSF. Likewise, files added to the Box folder in your OSF account will update your Box account with that file.

Dataverse

The OSF connects with the Harvard Dataverse or any other instance of Dataverse 4.0. Enabling Dataverse for your project allows contributors to view, download files, and upload files to/from a Dataverse study/dataset. Contributors to your project will have access to both released and draft versions of your study, but only the most recent release will be made public alongside your OSF project.

Dropbox

You can connect one Dropbox folder or an entire Dropbox account to your OSF project or component. Different Dropbox folders can be linked to different components within the same project.

After linking a Dropbox folder to an OSF project, its contents will be displayed in the Files Widget and the Files Browser. You can add files to your Dropbox folder and those files will be accessible via the OSF. Likewise, files added to your Dropbox folder in your OSF account will update your Dropbox account with that file.

figshare

figshare is an online digital repository that allows researchers to preserve and share their research outputs.

You can link your figshare project to an OSF project or component. Files added to your figshare project will be accessible via the OSF. You can connect to the root folder.  Likewise, files added to the figshare project in your OSF account will update your figshare project with that file.

Note: If your figshare file has been "published" on figshare, you are unable to delete the file.

Github

GitHub is a commonly-used web-based Git repository hosting service. You can link a GitHub repository to your OSF project or component. Files added to your GitHub repo will be accessible via the OSF. Likewise, files added to the GitHub repository in your OSF account will update your GitHub account with that file. You can also create a new GitHub repository from the OSF by clicking, "Create repo" from the Configure Add-on widget on the project settings page.  

GitLab

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.

Google Drive

Google Drive is a popular cloud storage service. You can connect one Google Drive folder or an entire Google Drive account to your OSF project or component. Different Google Drive folders can be linked to different components within the same project.

After linking a Google Drive folder to an OSF project, its contents will be displayed in the Files Widget and the Files Browser. You can add files to your Google Drive folder and those files will be accessible via the OSF. Likewise, files added to your Google Drive folder in your OSF account will update your Google Drive account with that file.

Google Docs, Sheets, and Slides will render in your browser via the OSF, but cannot be edited directly on the OSF. A link about the rendered Doc, Sheet, or Slides will take you to the add-on directly, where you can edit the materials if you have the appropriate permissions.

OneDrive

OneDrive is a cloud-based storage service that is part of the Microsoft suite of tools that allows you to store and share files. You can connect one OneDrive folder or subfolder per project. Different folders can be linked to different components within the same project. The connection with OneDrive is read-only, which means files added to your OneDrive folder will be viewable - but not editable - via the OSF.

ownCloud

ownCloud is an open source, universal file access platform that is self-hosted on your servers. You can link your ownCloud instance to your OSF project or component to see files stored there alongside files stored on OSF Storage or other storage providers.

Files added to ownCloud will be accessible via the OSF; likewise, files added to ownCloud via the OSF will be accessible on your ownCloud instance.