← Back to WPX Remote Uploads – Offload WordPress Media to Cloud / Remote Storage

WPX Remote Uploads – Offload WordPress Media to Cloud / Remote Storage Documentation

by WPX Plugin · version 2.6.4

WPX Remote Uploads — Full Documentation

A true WordPress "Uploads" folder replacement — offload media to cloud storage, serve it directly from there, and back up your database and site with one click.

Table of Contents

  1. Overview
  2. Requirements
  3. Installation
  4. Quick Start
  5. Dashboard: Overview Tab
  6. Connection Tab
  7. Behavior Tab (PRO)
  8. Migrate Existing Files (PRO)
  9. Sync to Local (PRO)
  10. Backup Tab
  11. License
  12. WPX Plugins
  13. Logs / Activity
  14. True Remote Storage Mode — Deep Dive
  15. Security Notes
  16. Troubleshooting & FAQ
  17. Uninstalling

1. Overview

WPX Remote Uploads connects your WordPress Media Library to S3-compatible cloud storage — Wasabi, Bunny Storage, Amazon S3, DigitalOcean Spaces, Google Cloud Storage, or any other S3-compatible provider — with no external dependencies. Everything is built on WordPress's own HTTP API.

Once connected, the plugin can:

The goal is simple: stop your hosting account from filling up with media, save on inodes and disk space, and give you a way to back up your site that doesn't depend on your host.

↑ Back to top

2. Requirements

↑ Back to top

3. Installation

  1. Upload the wpx-remote-uploads folder to /wp-content/plugins/, or install the zip directly through Plugins → Add New → Upload Plugin.
  2. Activate the plugin through the Plugins menu.
  3. A new WPX Remote Uploads menu appears in the WordPress admin sidebar.
  4. Go to WPX Remote Uploads → Dashboard to begin setup.

↑ Back to top

4. Quick Start

  1. Open the Connection tab and choose your storage provider — enable the Wasabi / S3-compatible card or the Bunny Storage card. Enabling one automatically disables the other as the active provider (you can still keep both configured and switch between them).
  2. Fill in that provider's credentials (Access Key / Secret Key, or Bunny's Storage Zone name and password) and click Test Connection to verify.
  3. Save your settings.
  4. Optionally, on the Behavior tab, enable auto-upload for new files and configure Selective Remote Serving.
  5. Optionally, run Start Migration to push your existing media library to the active provider.
  6. Check the Logs page any time to see exactly what the plugin has been doing.

↑ Back to top

5. Dashboard: Overview Tab

The Overview tab is the plugin's home screen. It shows:

This is also where success/error toasts appear after saving settings or activating a license.

↑ Back to top

6. Connection Tab

This is where you set up and manage your remote storage connection.

Active Storage Provider

A quick toggle at the top lets you pick which configured provider is currently active: Bunny Storage, Wasabi / S3-compatible, or None (local storage only).

Bunny Storage

Heads up Your Bunny Storage Zone must be created with "Enable S3 Compatibility" turned on — this can't be changed on an existing zone after the fact.

Wasabi / S3-Compatible

Each preset auto-fills a sensible default endpoint/region, which you can override for non-default regions.

Test Connection

Both provider cards have a Test Connection button that verifies your credentials against the live API before you rely on them.

↑ Back to top

7. Behavior Tab (PRO)

Controls exactly how offloading and serving behave.

Selective Remote Serving

Choose which media types are served from remote storage vs. local hosting. Images and video default to remote; audio and documents default to local. Fully overridable per type.

Auto-Upload New Files

When enabled, every new file uploaded to the Media Library is automatically pushed to the active remote provider.

True Remote Storage Mode ("Use Remote Drive for all operations")

The most powerful — and most impactful — setting on this tab. See Section 14 for full details before enabling it.

Performance

Lazy-loading and related delivery toggles for remote-served media.

↑ Back to top

8. Migrate Existing Files (PRO)

Moves your existing media library — everything already uploaded before you connected remote storage — to the active provider.

Before running on a live site Always click Test Connection first, and consider testing on staging.

↑ Back to top

9. Sync to Local (PRO)

The reverse of migration — pulls your entire remote library back down to local storage, in case you want to move away from remote storage or just want a local copy again.

↑ Back to top

10. Backup Tab

Two independent, one-click backup tools. Both upload privately to whichever cloud/remote storage is currently connected and active — never to a public URL — and both keep a history you can review or delete from within the plugin.

Database Backup to Cloud / Remote Storage

Site Content Backup to Cloud / Remote Storage

Note on size Best suited to small/medium sites. A very large backup may need more PHP memory available at the upload step, since the finished archive is read into memory in one piece for upload.

Recent Backups

Each backup type has its own history table showing date/time, size, table or file counts, the exact remote path it was stored at, and a Delete button that removes both the local history entry and the object from your storage.

↑ Back to top

11. License

Activate, validate, and deactivate your license key here, and control what this site shares with WPX.

Activating

Enter your license key and click Activate License. Successful activation redirects you straight to the Dashboard with a confirmation toast, and the PRO-only tabs (Behavior, Migrate, Sync) unlock immediately — no page refresh or re-login needed.

PRO Gating

Until a license is active, the Behavior, Migrate Existing Files, and Sync to Local tabs show their normal content — fully visible and readable — but every control on them is disabled, with a banner explaining the tab is a PRO feature and an Activate PRO button leading to the License page. Deactivating a license re-locks these tabs immediately.

Data Sharing

This site automatically checks in with WPX (domain, plugin version, plan, and WordPress/PHP environment) so it shows up under the vendor's Installs dashboard — this is covered under bestplugintheme.com's Terms & Conditions, and no separate notice is shown for it.

The one thing that's optional is sharing this site's admin email as part of that check-in, so the vendor can reach out if something needs attention. You'll see a one-time Yes/No notice for this the first time you visit one of the plugin's screens, and you can change your answer any time from this License page. It defaults to not sharing until you explicitly say yes.

↑ Back to top

12. WPX Plugins

A simple directory of other plugins by the same author (WPX Featured Image, WP AutoAzon, WP Power Analytics), each with a short description and a link to learn more. This plugin (WPX Remote Uploads) is marked as already active on this site.

↑ Back to top

13. Logs / Activity

A running log of everything the plugin has done — offloads, migrations, syncs, backups, license changes, and errors — each with a timestamp and a status (info, success, warning, error). Use this as your first stop when something doesn't look right.

↑ Back to top

14. True Remote Storage Mode — Deep Dive

Turning on "Use Remote Drive for all operations" (Behavior tab) makes your storage provider your uploads folder at the file-system level: WordPress's own file functions are transparently redirected to remote storage, so nothing is written to local hosting storage at all.

Before relying on this in production, be aware of a few real trade-offs:

↑ Back to top

15. Security Notes

↑ Back to top

16. Troubleshooting & FAQ

"Configure your [provider] connection first" is shown on the Migrate/Sync/Backup tabs.

The active provider isn't fully configured. Go to the Connection tab, fill in all required fields for your active provider, and click Test Connection.

Migration or Sync seems to stop partway through.

Both run in small batches specifically so they won't hit a host's execution time limit — check the Logs page for the exact point they stopped and any error recorded there, then use the Reset button and try again.

A backup fails with a message about the zip/ZipArchive extension.

Your host's PHP build doesn't have the zip extension enabled. Ask your host to enable it — this is required for both backup types since each compresses its export before uploading.

I don't see a Download button for my database or site backup.

This is intentional — both backup types are uploaded privately for security and are never exposed at a downloadable URL through the plugin. Access them via your storage provider's dashboard, or delete them from the plugin's History table if you no longer need them.

PRO tabs are still locked after I activated my license.

Activating a license redirects you straight to the Dashboard with the tabs already unlocked. If you're still seeing the lock, double check the License page shows "License active," and try a normal page reload.

Can I switch storage providers later?

Yes — configure the new provider's credentials on the Connection tab and switch the Active Storage Provider toggle. Existing offloaded files remain wherever they were uploaded; use Migrate/Sync if you need to move everything to the new provider.

↑ Back to top

17. Uninstalling

Deactivating the plugin stops auto-offload, scheduled cron tasks (license validation, telemetry check-ins), and PRO gating checks, but leaves your settings and any files already on remote storage untouched — nothing is deleted automatically. If True Remote Storage mode was active, deactivate it first and run Sync to Local if you want a local copy of everything before removing the plugin entirely.

↑ Back to top