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:
- OSX: Transmit
- Windows: CloudBerry Explorer
- Linux: AWS Command Line Interface
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
- 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.