Amazon S3

Step-by-step guide to setup Amazon S3 as a destination in RudderStack.

Amazon S3 (Simple Storage Service) is a cloud-based object storage service that allows customers and businesses to store their data securely, and at scale. With an easy to use interface and management features, S3 allows for effortless organizing of data to meet the business-specific requirements.

RudderStack allows you to configure Amazon S3 as a destination to which you can dump your event data seamlessly.

Setting up Amazon S3

Follow these steps to set up Amazon S3 before adding it as a destination in RudderStack:

  • Login to your Amazon AWS S3 console.

  • Create a new bucket. Alternatively, you can use an already existing bucket also.

  • You will need to provide an access key to authorize RudderStack to write to your bucket. To create this access key, go to My security credentials and create the key.

  • Make a note of both the access key ID and secret access key as these will required while configuring S3 as a destination.

If the AWS credentials are already configured on your machine where the RudderStack server is set up, you will not need the security credentials.

Configuring Amazon S3 in RudderStack

In order to enable dumping data to Amazon S3, you will first need to add it as a destination to the source from which you are sending event data. Once the destination is enabled, events from RudderStack will start to flow to Amazon S3. You will start seeing the files created in your S3 bucket.

To do so, please follow these steps:

  • Choose a source to which you would like to add Amazon S3 as a destination. You can also simply create a destination and connect it to a source later.

Please follow our Adding a Source and Destination guide to know how to add a source in RudderStack.

  • Select the destination as Amazon S3 to your source. Give your destination a name and then click on Next.

  • Next, in the Connection Settings, fill all the fields with the relevant information (please refer to the Setting up Amazon S3 section above) and click on Next.

If the AWS credentials are already configured on your machine where the RudderStack server is set up, you can skip adding the credentials in this step. Only the S3 Bucket Name is required.

  • If you need any transformation, choose one from the list. Else, click on Next.

That's it! You have successfully added Amazon S3 as a destination in RudderStack. Once you send an event from your source, you can find it dumped to your S3 bucket.

Contact Us

If you come across any issues while configuring Amazon S3 with RudderStack, please feel free to contact us or start a conversation on our Discord channel. We will be happy to help you.