OSF GuidesAdd-ons Storage add-onsConnect Amazon S3 to a Project

Connect Amazon S3 to a Project

You connect one Amazon S3 bucket to your project. Different buckets can be linked to different components within the same project. Files added to your Amazon S3 bucket will be accessible via OSF. Likewise, files added to the Amazon S3 bucket from your OSF account will update your S3 account with that file. 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.  

The Amazon S3 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.

1. Enable Amazon S3 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.

In the list of add-ons, click the Enable link next to Amazon S3.

The Amazon S3 terms will appear.

Read the terms, then click the Confirm button.

2. Configure Amazon S3

Find Amazon S3 in the "Configure Add-ons" section, then click the Connect Account link

The "Connect an Amazon S3 Account" modal will appear. Log in to Amazon S3, and generate access and secret keys.

Navigate back to your OSF project, and enter these keys into the respective fields.

Then click Save.

The "Import Amazon S3 Account" modal will appear.

Click Import.

3. Select a bucket

Next, select a bucket from the list, then click Save.

Amazon S3 will be connected to your project.