You can use Amazon S3™ as your storage provider in WHMCS.

Configure an Amazon S3 Storage Provider #

To configure Amazon S3 as your storage provider:

1. Go to Configuration () > System Settings > Storage Settings.
2. Select the Configurations tab.
3. Under Add New Configuration, select S3 and click +. Additional configuration options will appear.
4. Enter the Access Key, Access Secret, Bucket, and Region for your Amazon S3 bucket.
   • The S3 access credentials must have read and write access to the specified S3 bucket. This must include the following permissions:
     • ListBucket
     • GetObject
     • PutObject
     • ReplicateObject
     • DeleteObject
       For an example of a suitable policy for the S3 user, see Example Security Policy below.
   • You must specify the S3 region by its code name (for example, us-east-1 for US East (N. Virginia)).
5. If you are using an S3-compatible provider that is not Amazon S3, enter an endpoint URL for your provider. The system doesn’t require the Endpoint URL value if you’re using the Amazon S3 service.
   Endpoint URLs must begin with https://.
6. Click Save Changes.

Migrate from Local Storage to Amazon S3 #

To migrate from local file storage to your configured Amazon S3 storage:

1. Go to Configuration () > System Settings > Storage Settings.
   
2. For each file asset type that you wish to change, select the desired S3 storage location.
3. Click an option for changing the storage location:
   • Click Migrate to automatically migrate all of the stored files in the current storage location to the newly-selected location.
     • For smaller scale deployments, migration will take less than a minute, and your files will then exist in the new location.
     • If the migration cannot happen immediately, the system will schedule it to run in the background. Until it finishes, the system will continue using the former location.
   • Click Switch to change the storage location without performing any automatic migrations. Use this when you plan to migrate the existing stored files manually or have already migrated them.
4. If you clicked Migrate, after the automatic migration finishes, validate whether the migration was successful.
5. Delete the files in the prior location. The system will not automatically delete these files.

Example Security Policy #

For advanced users, an example Amazon S3 policy to assign to the S3 user for use with WHMCS storage settings is below:

  {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "Stmt1111222223333",
               "Effect": "Allow",
               "Action": [
                   "s3:ListBucket",
                   "s3:GetObject",
                   "s3:GetObjectAcl",
                   "s3:PutObject",
                   "s3:PutObjectAcl",
                   "s3:ReplicateObject",
                   "s3:DeleteObject"
               ],
               "Resource": [
                   "arn:aws:s3:::<BUCKET_NAME>",
                   "arn:aws:s3:::<BUCKET_NAME>/*"
               ]
           }
       ]
   }

Cancel a Migration #

To cancel an ongoing migration, click Revert Changes. The system will then continue using the current location but will not delete any files that are already in the new location.

Last modified: June 14, 2024