Knowledge Base

Hi, How can we help?

Quick Start : Amazon Web Services (AWS)

This guide is set up to help you offload your WordPress Media Library to an Amazon S3 bucket using Offload Media swiftly and promptly.

Logging in to the AWS Console

To create an IAM User you will need to first log in to your pre-existing AWS account from here.
If you do not have an AWS account you can simply register a new one from here.

Creating an IAM User

After logging in to your AWS account you will need to set up a new IAM user.

For this, you will need to maneuver your way to the IAM Users page in the AWS console and click the ADD USER button.

You can set your preferred authentic name in the User Name field.

Names are case insensitive and must be unique within your AWS account. User names can be a combination of up to 64 letters, digits, and these characters: plus (+), equal (=), comma (,), period (.), at-sign (@), and hyphen (-).

Select the checkbox for programmatic access under access type then proceed with the next: permissions button.

Specific permission

Giving full access to S3 for the new user is the preferred way moving forward. The “AmazonS3FullAccess” policy is designed to help new users to avoid and limit running into potential problems while first setting up Offload Media – Cloud Storage for the first time. Users who have been using AWS previously may choose to create their own Custom IAM Policy. A user can always go back and edit their IAM user policy so that only essential resources for offload media are made required.

Click the “Attach existing policies directly” button, and then enter “s3” in the filter policies input box.

Before clicking the Next:Tags button at the bottom of the page you need to select the “AmazonS3FullAccess” policy.

The third page is to add tags, adding tags is completely optional as it is mostly used by experienced AWS users to help with management tasks. After deciding upon tags you can click the Next:Review button at the bottom of the page to move to the next page.

If you’re happy with the selections you can click on the Create User button.

The next page will display the security credentials for the new user, which consist of an Access Key ID and a Secret Access Key. Amazon will only show these credentials once so it is advised to download these credentials as a .csv file and keep them safe as you can only create a new set of keys from the console but cannot recover the secret key again

Clicking the close button will take you back to the IAM Users page.

Create an Amazon S3 Bucket

You need to set up an Amazon S3 Bucket to store the media.

For this, you will need to maneuver your way to the Amazon S3 page in the AWS console and click the Create Bucket button.

You can enter your bucket name in the field Bucket Name, And choose a region for the bucket to be hosted from the field AWS Region in section General Configuration.

In the next step, you can choose the object ownership type,

You can choose ACLs disabled when all objects in this bucket are owned by this account. Access to this bucket and its objects is specified using only policies.

Otherwise, you can choose ACLs enabled when Objects in this bucket can be owned by other AWS accounts. Access to this bucket and its objects can be specified using ACLs.

In the next step, you can set the public access settings,

Uncheck all the checkboxes and enable public access to the bucket.

Rest of the settings you can keep the default settings, And click on to Create Bucket Button.

Then, Your bucket will be created in the specified region.

If you got any permission issues you can mention the bucket policies by adding a policy in JSON format.

You can use the below policy for the same.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": [
                "s3:DeleteObjectTagging",
                "s3:ListBucketMultipartUploads",
                "s3:DeleteObjectVersion",
                "s3:ListBucket",
                "s3:DeleteObjectVersionTagging",
                "s3:GetBucketAcl",
                "s3:ListMultipartUploadParts",
                "s3:PutObject",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:GetBucketLocation",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::<BUCKET_NAME>/*",
                "arn:aws:s3:::<BUCKET_NAME>"
            ]
        }
    ]
}

Replace <BUCKET_NAME> with your bucket name

Configure Plugin

After installation, maneuver your way to the admin page Offload media -> Configure 

You can see a welcome screen, By clicking on the Next button you will be redirected to a Service selection page,

You can choose the service that you want to configure on your WordPress site.

Here we choose Amazon S3 and forward the step by clicking the Next button.

Then, You can see a welcome screen of the Amazon S3 configuration. If you’re confused about the configuration you can go to our documentation page from this screen.

Click on the Next button to configure the service,

Now you will get a screen that looks like the below screenshot, Here you can enter the previously created credentials for the Amazon S3 configuration.

Then click on the button Next to verify the credentials that you are entered.

And in the next step, you will get a verified result page if it is successful you can click on to Save Configuration button to save the settings. If it fails to verify then you can go back and edit the credentials easily,

Yes,

Finally, you are ready to offload the media

Happy Offloading

Customer Support

If you have questions about our plugin(s), are experiencing issues with any of our plugin