Set Up an Amazon S3 Bucket

If you want to use Amazon S3™ as the storage provider for your WHMCS installation, you will need to create an S3 bucket.

Create an S3 Bucket

To create an Amazon S3 bucket:

1. Log in to your Amazon account.

Log in to your Amazon account.

2. Create a bucket.

Go to S3.

Go to S3 in the menu

Click Create bucket.

3. Configure your bucket.

To configure your bucket:

  1. Choose your desired region.
  2. Select a bucket type.
  3. Enter a name for your bucket.
  4. Configure the other bucket settings according to your needs. In most cases, for private buckets, you use the default settings.

Configuring the S3 bucket settings

4. Create a user.

Go to IAM.

Select IAM

Click Users and then click Create user.

5. Configure the user.

Enter a username and click Next.

Then, select Attach existing policies directly.

Select Attach existing policies directly

6. Create a policy.

Click Create policy. The policy editor will display.

Configure the policy:

  1. Select S3 for Service. The available S3 permissions settings will appear.
  2. Under Access Level, select the following permissions:
  • ListBucket under List.
  • GetObject under Read.
  • PutObject, ReplicateObject, and DeleteObject under Write.
  1. Under Resources, select Specific.
    Select Specific
  2. Add an ARN:
    1. Click Add ARNs under bucket.
      Click Add ARNs
    2. Enter the name of the bucket that you created earlier.
    3. Click Add.
    4. Click Add ARN under object.
    5. For Resource bucket name, enter the name of the bucket that you created.
    6. Select Any object name.
    7. Click Add ARNs.
  3. Click Next.
  4. Under Policy details, enter a name for the new policy and, optionally, a description to help you identify it later.
    Add a policy name and description
  5. Click Create Policy. A success message will appear.

7. Select the policy.

Return to the previous tab and refresh the list of policies.

Then, select the policy that you created and click Next.

8. Select the user.

Click Create user and select the user.

9. Create an access key.

In the Summary section:

  1. Click Create access key.
  2. Select Third-party service.
  3. Select the checkbox under Confirmation.
  4. Click Next.
  5. Click Create access key.

10. Store the ID and secret.

Copy and store the displayed ID and secret. You will need them in order to configure the bucket in WHMCS.

11. Click Done.

Click Done.

Last modified: January 2, 2025