Guides & TutorialsSystem SettingsStorage SettingsSetting up an Amazon S3 Bucket for use with WHMCS

Setting up an Amazon S3 Bucket for use with WHMCS

This article describes how to create an S3 Bucket using Amazon Web Services for use with WHMCS as a Storage Provider.

Begin by logging in to your Amazon account at https://aws.amazon.com/

Next, navigate to the S3 service.

Select S3

Click the Create bucket button.

Click Crete bucket

Enter a name for your bucket and choose your desired region.

Enter a Bucket Name and select a Region

Configure all other settings as desired. In most cases using the default settings for a non-public bucket will be fine.

Next navigate to the IAM service.

Select IAM

Select the Users tab on the sidebar and then click Add user.

Add User

Enter a user name for your user and check the "Programmatic access" option under Access Type. Then click Next.

Enter username and select Programatic Access

On the following screen, select "Attach existing policies directly" and then click the "Create policy" button.

Select Attach existing policies directly and click Create policy

The visual policy editor will load. Select S3 under the "Service" section and select all of the following S3 related permissions: ListBucket, GetObject, PutObject, ReplicateObject, DeleteObject

Select the required service permissions

Under Resources, select Specific and then click the Add ARN link under the bucket subheading.

Select Resourses > Specific and click Add ARN

Enter the name of the bucket that you created earlier and then click Add.

Enter the name of the buck and click Add

Now click the Add ARN link under the object resource type subheading.

Add an Object ARN

Enter the name of the S3 bucket you created earlier into the Bucket Name field, enter check the Any checkbox for the Object Name field. Then click Add.

Enter the name of your bucks and tick the "Any" checkbox

The Create Policy screen should now look as follows. Once you are happy with the values, click the Review Policy button to continue.

Click Review Policy

Enter a name for the new policy and optionally also a description to help you identify it later. Then click Create Policy.

Enter a name and description. Click Create Policy

You will see a successful confirmation as follows.

Success!

Now return to the previous tab where you began creating the user and refresh the list of policies.

Enter the name of the newly created policy

Enter the name of the policy you created into the Search bar and then select the policy from the search results below.

Select the newly created policy

Next you will be asked to assign tags. Assign any tags if desired, and then continue to the Review step. The review screen should look like the one below. Once you are happy, click Create User to complete the process.

Click Create user

On the following screen you will be provided with the programmatic access key ID and secret. Copy these and store them safely. You will need them to configure WHMCS.

Note the Access Key ID and Secret safely

You may now continue to the article for setting up S3 inside WHMCS.