How to download MATTR GO artifacts from an AWS S3 bucket

Overview

This guide supports MATTR GO whitelabel clients who receive application artifacts via an AWS S3 bucket. It outlines how to download those artifacts using the AWS CLI in one of the following methods:

Using your own AWS account: you can access the S3 bucket directly with your own AWS credentials by assuming a role that has access to the bucket. This method requires you to have an AWS account and the necessary permissions.
Using MATTR’s provided AWS credentials: you can access the S3 bucket and download artifacts using MATTR’s AWS credentials, which allows you to download the artifacts without requiring an AWS account of your own.

Prerequisites

Working with the S3 bucket

List available files

To explore what’s available in the S3 bucket, use:

List files in S3 bucket


aws s3api list-objects --bucket '{your-bucket-name}' --region '{aws-region}'

Example output:

The following example shows a folder named 0.0.1 containing a file called test.txt.

Example output


{
    "Contents": [
        {
            "Key": "0.0.1/",
            "LastModified": "2025-05-29T21:37:23+00:00"
        },
        {
            "Key": "0.0.1/test.txt",
            "LastModified": "2025-05-29T21:38:18+00:00"
        }
    ]
}

Download a specific file

Use the following command to download an artifact from the bucket:

Download a file from an S3 bucket


aws s3api get-object \
  --bucket '{your-bucket-name}' \
  --key '{path-to-file-in-S3, e.g. 0.0.1/test.txt}' \
  --region '{aws-region}' \
  local/path/where/to/save/file.ext

This will retrieve the specified file and save it to your local path.

Need Help?

If you encounter any issues or have questions, please contact us. We’re here to help ensure your deployment is seamless and secure.