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.

For more details about Templates and security, see our Template documentation.
For more information on saving to S3, such as how to customize file names, see the 🤖/s3/store documentation.

How do I set up an Amazon S3 bucket?

More

See also: