Configuring AWS S3 Buckets

Introduction

This guide is for systems running V20 Update 7. Follow these steps to properly configure your AWS account and S3 Bucket in order to use it as a remote storage on your 3CX PBX.

Create a Policy

  1. Sign in to your AWS Console at https://console.aws.amazon.com/ and navigate to IAM
  2. Under “Access Management” chose “Policies” then press the “Create Policy” button
  3. Switch to “JSON” and replace the content in Policy Editor with the content of the IAM config file generated from 3CX Admin Console > Integrations > Amazon > Generate IAM Config File

  1. Press the “Next” button
  2. On the next screen, give a policy name and click on Create Policy

Create a User

  1. In the AWS console > IAM  select “Users” and press the “Create user” button

  1. Set “pbx-service-account” as user name and press “Next”
  2. Select “Attach policies directly” and select the policy you have created before

  1. Click on Next to Review the user and finally press the “Create user” button

Create Credentials

  1. In the AWS console > IAM navigate to “Users” and select the “pbx-service-account” user you’ve just created

  1. Press “Create access key”
  2. Select “Other” then press the “Next” button, then “Create access key”
  3. Copy and store the access key and the secret access key or download the CSV file. You will need to use these in the Amazon Integration page in the 3CX Admin Console.

  1. Press “Done” button in the AWS console to close the dialog

Create an S3 Bucket

  1. Sign in to AWS Console at https://console.aws.amazon.com/ 
  2. Navigate to S3 service > General Purpose Buckets
  3. Select the Region you would like your bucket to be hosted in the right-top corner
  4. Click “Create bucket” and enter the bucket name
  5. If the wizard asks for “Bucket type”, make sure to  select the “General purpose” option
  6. Leave Other options to default, or configure as need
  7. Click on Create Bucket

  1. Make a note of the selected region’s name as you will need to enter it in the Amazon Integration Page in 3CX Admin Console, e.g. “us-east-1”, “eu-central-1”

Configure Amazon Integration in 3CX Admin Console

  1. Log in to your 3CX Admin Console and navigate to Admin > Integrations > Amazon
  2. Fill in the Access Key ID and Secret Access Key that you created in the AWS Console before
  3. Fill in the Bucket Name and the Region selected in the previous steps
  4. Select the “Apply this bucket for remote storage” option to automatically configure this bucket for remote storage

Configure Remote Storage Settings for Archiving

  1. In 3CX Admin Console navigate to Admin > System > Storage
  2. Enable Remote Storage and select AWS S3 Bucket in Location Type
  3. Select the Root Path that the PBX will be archiving data to. You can select the main Bucket root or any subfolder in the S3 Bucket.
  4. Select the data you want PBX to archive on your S3 Bucket and click on Save 

Last Updated
This document was last updated 10 September 2026
https://www.3cx.com/docs/aws-s3-buckets/