How to download MATTR GO artifacts via an AWS S3 bucket without an AWS account

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, without needing an AWS account of your own.

Prerequisites

To access and download files from the S3 bucket, you’ll need the following:

1. Install the AWS Command Line Interface (CLI)  on the machine where you’ll be downloading the artifacts.

2. Ensure you have the following access credentials (provided by MATTR via a secure channel. You do not need your own AWS account to use them):

   • AWS Access Key ID
   • AWS Secret Access Key

3. We recommend setting the credentials as environment variables :

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key

Working with the S3 bucket

List available files

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

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.

{
    "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:

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.