> For the complete documentation index, see [llms.txt](https://help.rzr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rzr.com/readme/audience-sharing-setup/s3-bucket-setup.md).

# S3 Bucket Setup

This document outlines how to connect to and use an Audience S3 bucket for RZR. It covers three options:

1. [Cyberduck](#option-1-using-cyberduck)
2. [AWS Command Line Interface (CLI)](#option-2-using-aws-cli-command-line-interface)
3. [Python script](#option-3-using-a-script)

***

### Option 1: Using Cyberduck

To connect to a S3 bucket from Windows PC / Mac we use a client called Cyberduck.

To download this program you need to access the following link: <a href="https://cyberduck.io/" class="button primary" data-icon="hand-pointer">cyberduck.io</a>

After downloading the Cyberduck client, run the program (as an Administrator in Windows).

The installation process is very simple:

* When prompted with the Cyberduck Welcome screen, press the Install button and the\
  program will be installed automatically.
* After the installation is done, run the program.

In the bottom left corner of the program you will find the “+” button to create a new bookmark

<figure><img src="/files/fFO8LD0WzWtpDEZuBLzS" alt=""><figcaption></figcaption></figure>

Click on the “+” button to show the new Bookmark dialog box

<figure><img src="/files/mxZJCF3kz9gnQ1HePoKb" alt=""><figcaption></figcaption></figure>

In the first field the **Amazon S3** (Amazon Simple Storage Service) protocol must be selected. After that the following fields MUST be completed:

* **Nickname**: give a name for the connection (for example, RZR)
* **Server**: must be set to s3.amazonaws.com
* **Port**: must be set to 443
* **Access Key ID**: your Access Key ID for the desired bucket must be entered (to be provided)
* **Path**: must be set to the folder name provided to you
* **Secret Access Key**: To be shared

Close the bookmark dialog box, and double click on the newly created bookmark to establish the\
connection.

<figure><img src="/files/DLliZ4hsqLA58gIE99tr" alt=""><figcaption></figcaption></figure>

***

### Option 2: Using AWS CLI (Command Line Interface)

To connect to S3 bucket using AWS Command Line Interface or CLI, please follow the instructions as listed by Amazon <a href="https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions" class="button primary" data-icon="hand-pointer">AWS CLI</a>

Once installed, open a shell and configure a profile for RZR

* <mark style="color:$primary;">`aws configure --profile aarki_s3`</mark>

Add the access keys in the prompt

* <mark style="color:$primary;">`AWS Access Key ID:`</mark> Your Access Key ID for the desired bucket (to be provided)
* <mark style="color:$primary;">`AWS Secret Access Key:`</mark> (To be shared)
* <mark style="color:$primary;">`Default region name [None]: us-east-1`</mark>
* <mark style="color:$primary;">`Default output format [None]:`</mark>

Now copy the file using the following commands:

* <mark style="color:$primary;">`aws s3 cp FILE_PATH_ON_COMPUTER s3://S3_PATH --profile aarki_s3`</mark>

where

* <mark style="color:$primary;">`FILE_PATH_ON_COMPUTER:`</mark> The file you want to copy to S3 bucket&#x20;
* <mark style="color:$primary;">`S3_PATH:`</mark> The name of bucket provided to you by RZR

***

### Option 3: Using a script

If you prefer to use a script to upload files to the S3 bucket, you can use the following code example\
that you can save as **upload\_s3.py**.

<pre data-overflow="wrap"><code>import argparse
import boto3
from botocore.exceptions import NoCredentialsError, PartialCredentialsError
import os

def upload_to_s3(local_file, bucket_name, s3_file, aws_access_key_id,
aws_secret_access_key, region_name='us-east-1'):
        # Create an S3 client with hardcoded credentials
        s3 = boto3.client('s3',
                        aws_access_key_id=aws_access_key_id,
<strong>                        aws_secret_access_key=aws_secret_access_key,
</strong>                        region_name=region_name)
        try:
                        s3.upload_file(local_file, bucket_name, s3_file)
                        print(f"Upload Successful: {local_file} to s3://{bucket_name}/{s3_file}")
        except FileNotFoundError:
                        print(f"The file {local_file} was not found")
        except NoCredentialsError:
                        print("Credentials not available")
        except PartialCredentialsError:
                        print("Incomplete credentials")
        except Exception as e:
                        print(f"An error occurred: {e}")

if __name__ == "__main__":
                AWS_ACCESS_KEY_ID = 'REPLACE_THIS_WITH_AWS_ACCESS_KEY_ID'
                AWS_SECRET_ACCESS_KEY = 'REPLACE_THIS_WITH_AWS_SECRET_ACCESS_KEY'
                AWS_REGION = 'us-east-1'

       parser = argparse.ArgumentParser(description="Upload a file to an S3 bucket")
       parser.add_argument('--local_file', required=True, help="Path to the local file")
       parser.add_argument('--bucket_name', required=True, help="Name of the S3 bucket")
       parser.add_argument('--s3_file', required=True, help="S3 object key (path in the bucket)")
       parser.add_argument('--aws_access_key_id', default=AWS_ACCESS_KEY_ID, help="AWS Access Key ID")
       parser.add_argument('--aws_secret_access_key', default=AWS_SECRET_ACCESS_KEY, help="AWS Secret Access Key")
       parser.add_argument('--region_name', default=AWS_REGION, help="AWS region name (default: us-east-1)")
       
       args = parser.parse_args()
       
       upload_to_s3(args.local_file, args.bucket_name, args.s3_file, args.aws_access_key_id, args.aws_secret_access_key, args.region_name)
</code></pre>

In the above example, replace the highlighted red text as follows

* <mark style="color:$danger;">`REPLACE_THIS_WITH_AWS_ACCESS_KEY_ID:`</mark> Your Access Key ID for the desired bucket (to be provided)
* <mark style="color:red;">`REPLACE_THIS_WITH_AWS_SECRET_ACCESS_KEY:`</mark> (To be shared)

To run the script, use the following command from a shell

{% code overflow="wrap" %}

```
python3 upload_s3.py --bucket_name BUCKET_NAME --s3_file FILE_NAME_TO_UPLOAD --local_file FILE_NAME_TO_UPLOAD
```

{% endcode %}

where

* <mark style="color:$primary;">`upload_s3.py:`</mark> The name of the script&#x20;
* <mark style="color:$primary;">`BUCKET_NAME:`</mark> The folder name provided to you&#x20;
* <mark style="color:$primary;">`FILE_NAME_TO_UPLOAD:`</mark> The name of the file to upload

***

This guide covers everything you need to upload audiences to RZR via S3 Bucket — including connection options, required credentials, and step-by-step instructions for Cyberduck, AWS CLI, and Python.

If you need help with setup, reach out to your **RZR Account Manager** or **Account Coordinator** for assistance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.rzr.com/readme/audience-sharing-setup/s3-bucket-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.