LargeFS is a product created by WP Engine, designed to store and transfer virtually unlimited amounts of data and integrate it into the familiar WordPress experience.
For more information on what LargeFS is, read our announcement post, Unlimited Storage with WP Engine’s Proprietary LargeFS.
To configure LargeFS, here is a summary of what you will need to do:
- Create an AWS S3 Bucket
- Give WP Engine access to read, write, and list objects in that bucket
- Make the bucket world readable as a static website.
- Provide bucket name and region to WP Engine by submitting support request
Detailed instruction on each step are below.
Creating a Bucket
To create a bucket, login to your AWS console and choose S3 from the list of services. Once in the S3 console, click the Create Bucket button:
Give the bucket a name, that meets the following criteria:
- The name must be globally unique. Amazon does not allow bucket names to be reused; not even in different accounts.
- The bucket must start with a letter and contain only letters (lowercase only), numbers, and hyphens.
For this example, we chose largefs-fb23d456, but you will need to choose your own. Select a region you want to host your bucket in. Be sure to remember the region as you will need to provide this later to WP Engine Support. Now click “Create”.
Assigning Permissions to LargeFS
Next we need to assign the required permissions to the bucket, so that LargeFS can begin placing files in the bucket.
Find and select the bucket you just created in the list of buckets. Next, click “Permissions” to reveal the permissions page. Now click “Bucket Policy”. In the bucket policy editor, copy the policy below, which grants the WP Engine LargeFS user rights to read and write objects in your bucket, and replace the placeholder “your-bucket-name” with the bucket you created. Be sure to keep the “/*” while replacing the placeholder.
Once you have replaced the placeholders with your bucket name, click “Save” in the Policy Editor.
Enabling Static Website Hosting
Finally, we need to enable the bucket for static website hosting.
Click “Properties” in the top menu. Now, click “Static Website Hosting”, click “Use this bucket to host a website“, specify “index.html” for the Index Document and click “Save”.
Sometimes it takes some time for AWS permissions to propagate, so it may take some time before LargeFS can begin uploading content.
Note: The policy and settings above makes your bucket world-readable. This is because when WP Engine goes to retrieve your files from the bucket, it does this as if it was a user on the internet. Because of this, it is important that you do not store any non-public files in the bucket. Best practice is to not store any files in the bucket that are not managed by LargeFS.
Provide Your Bucket Details to WP Engine
All that is left is to provide the bucket details to WP Engine. You can do this by opening a 24/7 Live Chat in your User Portal that includes your bucket name and bucket region. The Support technician will then walk you through the process of validating your S3 bucket with our system.
Once this process is completed, we will start copying over files from your local wp-content/uploads to your new Amazon S3 bucket. Going forward, we will continue to copy over new files uploaded over to S3.