How do I set up an Amazon S3 bucket?

1. Sign up for an Amazon S3 Account

To use S3 buckets, you will first need an Amazon S3 account. To sign up, go to the S3 Service Page and click the "Get started with Amazon S3" button.

2. Locate your credentials

To locate the credentials for your account, you will need to:

  • Go to the AWS Management Console
  • Hover over your company name in the top right menu and click "My Security Credentials"
  • Scroll to the "Access Keys" section
  • Click on "Create New Access Key"
  • Take note of both the Access Key ID (YOUR_AMAZON_S3_KEY) and Secret Access Key (YOUR_AMAZON_S3_SECRET)

Important For security reasons, we recommend setting up an IAM user with limited permissions as documented in 🤖/s3/store docs.

3. Create a bucket

To create an S3 bucket, use the S3 Management Console online, or use a local client that supports the S3 API. We recommend any of the following:

Make sure to take note of the name of your Bucket Name (YOUR_AMAZON_S3_BUCKET) after you create it.

4. Use the bucket with Transloadit Templates

Assuming you have signed up for Transloadit, proceed to Template Credentials then under "Adding new Credentials", select "Amazon S3" and input the relevant information from the earlier steps.

The following is an example of a simple Template for testing the connection to your S3 account.

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/s3/store",
      "use": ":original",
      "credentials": "YOUR_S3_CREDENTIALS"
    }
  }
}

To see if it works, in the created Template's Testing section click "Toggle Testing Area" and upload an item.

More

See also:

How can I test notifications in a dev environment? Why are there Transloadit watermarks on my files? What are Assemblies?