Offload Files to a Bucket Through Media Cloud

Overview

You can use this document to learn how to offload image and media files from a WordPress server to your object storage bucket.

With this workflow:

To use this document, you must have the following information available:

Required information	Description
The access key and secret key for object storage	If you did not generate keys for your object storage or if you cannot remember your keys, you can always generate new keys that will replace your existing keys. To learn how to generate keys, see Create and Manage Object Storage Buckets and review the information under Access and manage your bucket.
The bucket's region	Each region has a separate endpoint URL. If you do not know your bucket's region, you can obtain that information in the StackPath Control Portal. In the portal, in the left-side navigation menu, click Object Storage. Locate the desired bucket, and then note the information under Region.
The StackPath edge address for the CDN site that uses object storage as the origin	To obtain the edge address: In the portal, in the left-side navigation menu, click Sites. Locate and select the desired site. In the top, right corner, note the edge address. If you have not created a CDN site that uses object storage as the origin, see Create and Manage Object Storage Buckets, and then review the information under Create a site with an object storage origin.

Each region has a separate endpoint URL. Based on your region, review the list of endpoint URLs:

Access Media Cloud.
In the left-side navigation menu, click (or hover over) Plugins, and then select Add New.
Search for Media Cloud for Amazon S3, and click Install Now, and then click Activate.

Open the Setup Wizard.
Select S3 Compatible.
Complete the missing fields, and then click Next.
- In Access Key and Secret, enter your object storage's keys.
- In Bucket, enter your bucket's name.
- In Region, select your bucket's region.
- In Custom Endpoint, enter the endpoint URL that includes your bucket's region.
Follow the on-screen instructions to test and verify the settings.
If there are any error messages, resolve the errors, and then perform a system check to verify your changes.
Navigate to the CDN Settings section. Next to CDN Base URL, enter the StackPath edge address for the CDN site that uses object storage as the origin. This action will establish the connection between the CDN and your bucket, which will allow files from the bucket to be stored and served from cache.

You can use these instructions to upload new images to your bucket through Media Cloud.

In Media Cloud, in the left-side navigation menu, click (or hover over) Media, and then click Add New, and then add your media to WordPress.
Now, any new images that are added in this manner will be automatically uploaded to your bucket. To verify, in your Media Library, select the cloud icon next to an image, and then verify the URL.

You can use these instructions to upload existing media from your WordPress instance within the Media Library to your bucket.

In your WordPress admin panel, navigate to Media Cloud.
In the left-side navigation menu, select Migrate to Cloud, and then click Import Uploads.
Now, your images are stored in your bucket. To verify, in your Media Library, select the cloud icon next to an image, and then verify the URL.

Was this article helpful?