Docs menu Guides / Switching providers

Switching providers

Plume stores files under the provider and bucket in your settings. To change either one, bring the files back first, then offload them again to the new place.

Steps

  1. Take a backup of your database and wp-content/uploads.
  2. Under Tools → Bulk media jobs, select Restore local copies. Wait for it to finish with no failures. This downloads every offloaded file from the old bucket.
  3. Put post content back on local URLs:
wp nimbus revert --limit=500
  1. Go to Settings, change the provider and credentials, and select Save Settings. Use the page for your new provider, for example Cloudflare R2.
  2. Select Test Connection under Tools.
  3. Select Offload existing library to upload everything to the new bucket. See bulk migration.
  4. Check the front end, then clean up the old bucket.

Things to know

  • Restoring downloads files to the path stored on each attachment. Make sure there is enough disk space for the whole library.
  • If you use a Path Prefix, try the restore and offload on a few files first, or on a staging copy, and confirm the keys in the new bucket look right.
  • If you only change the public address, for example by adding a CDN, you do not need to move files. Set a custom domain and update stored URLs with wp nimbus replace-urls.
  • Keep the old bucket until you have checked pages, galleries and downloads.

Tip: Export your settings first from Tools → Configuration backup. See config export.