Offloft 0.1.0 is here: offload your WordPress media and know it arrived.Read what's new
Browse the docs

Getting started

Go from a fresh install to a library that's offloaded and verified. Read these in order, or jump to the one you need.

Before you startCheck versions in Tools → Site Health → Info
WordPress6.5 or laterDashboard → Updates
PHP8.1 or laterWith the cURL extension
StorageA provider accountR2, S3 or S3-compatible
AccessSite adminTo install plugins

In this section

01Install OffloftInstall the free Offloft plugin from a zip file, and check what it needs.
  1. Download the zip from the download page.
  2. Go to Plugins → Add New → Upload Plugin and choose the file.
  3. Click Install Now, then Activate.
  4. Open Offloft in the admin menu. The setup wizard starts there.
Read the full page
02Your first offloadThe setup wizard in order, from choosing your storage to starting your first offload.
  1. Storage. Choose your provider. Each one has a step-by-step guide for its own dashboard.
  2. Connect. Paste your access keys and bucket. A live connection test checks each step and points at the one to fix if something fails.
  3. Delivery. Choose the address your media loads from, and run the delivery test.
  4. Safety. Choose your safety defaults: keep local copies, and offload new uploads automatically.
  5. Scan. Run the pre-flight scan. It counts your files and flags anything that would get in the way.
  6. Start. Start offloading. It runs in the background, so you can close the page.
Read the full page
03Moving your existing libraryRun the pre-flight scan, then offload every existing file in the background with pause and cancel.

To move an existing media library, run the pre-flight scan in Tools, check what it found, then start Offload everything in Jobs. Work runs in the background in small batches, with pause and cancel. New uploads offload by themselves. Each file keeps loading from your server until its cloud copy is verified.

Read the full page
04RequirementsWhat Offloft needs to run: WordPress, PHP, cURL, a bucket and working background tasks.

Offloft needs WordPress 6.5 or later and PHP 8.1 or later with the cURL extension, plus a bucket with Cloudflare R2, Amazon S3 or any other S3-compatible storage. You bring the bucket and pay your provider directly. Background work needs WordPress's scheduled tasks to run.

Read the full page
Prefer a walkthrough?Set up Offloft in five stepsThe setup guide, with your provider's steps and the connection test.Open the setup guide Next sectionConceptsHow Offloft moves, checks and serves files.Read Concepts

Type to search.