AWS S3
Last updated
Was this helpful?
Last updated
Was this helpful?
You can configure your own AWS S3 bucket to receive location updates from Roam servers in daily batch uploads. This setup is ideal for teams that want to own and store location data directly in their cloud infrastructure.
Before getting started, make sure you have:
An active AWS account
Permission to create S3 buckets, IAM policies, and IAM roles
Access to the
Log in to your AWS account and search for S3 in the top navigation bar.
Click Create bucket, and fill in the required fields:
Bucket name: Use something simple like roam-daily-location-dump
Region: Choose the AWS region closest to your infrastructure
Leave all other settings as default.
Click Create Bucket at the bottom to finish.
To allow Roam to write data into your S3 bucket, you’ll need to create an IAM policy that grants s3:PutObject permission.
From the AWS Console, search for and navigate to the IAM service.
Click Policies in the sidebar, then click Create policy.
Switch to the JSON tab and paste the following:
Replace roam-daily-location-dump with your actual bucket name.
Give your policy a name like S3UploadPolicy and click Create Policy.
This role allows Roam’s AWS account to securely upload data to your S3 bucket using temporary credentials.
In the IAM console, click Roles in the sidebar, then click Create Role.
When prompted for the type of trusted entity, choose Custom trust policy, and paste:
This grants Roam temporary permission to upload data to your bucket without exposing your AWS credentials.
Search for the policy you created in Step 2 (e.g., S3UploadPolicy), and attach it to this role.
Give your role a name like RoamS3UploadRole, add an optional description, and click Create Role.
Once the setup is complete, share the following details with your Roam/Echo contact:
AWS Account ID
S3 Bucket Name
AWS Region
IAM Role Name
This allows Roam to securely deliver your data to the correct destination.
Once Roam begins uploading, you can access your data through the AWS Console.
Search for S3 and open the service. Find and select the bucket you created (e.g., roam-daily-location-dump).
You’ll now see location update files uploaded by Roam — organized by date or event.
🧪 Test Tip: Ask your Roam contact to perform a test delivery and confirm the file shows up in your bucket.
