# Plume

> Plume is a free, open source WordPress plugin that offloads your Media Library to Amazon S3, Cloudflare R2 or any S3-compatible storage and rewrites every URL.

Move your media to the cloud. Keep your workflow.

Plume offloads your Media Library to Amazon S3, Cloudflare R2 or any S3-compatible bucket, and rewrites every URL so pages load from storage or your CDN.

- License: MIT. No license server, no telemetry, no paid tier.
- Requirements: WordPress 6.0+, PHP 8.1+. Multisite ready.
- Install: [Installation](https://plume.arunprakashg.com/docs/)
- Source: [GitHub](https://github.com/ArunPrakashG/media-offload)

## Supported storage

- [Amazon S3](https://plume.arunprakashg.com/docs/providers/amazon-s3/)
- [Cloudflare R2](https://plume.arunprakashg.com/docs/providers/cloudflare-r2/)
- [Google Cloud Storage](https://plume.arunprakashg.com/docs/providers/google-cloud-storage/)
- [Backblaze B2](https://plume.arunprakashg.com/docs/providers/backblaze-b2/)
- [DigitalOcean Spaces](https://plume.arunprakashg.com/docs/providers/digitalocean-spaces/)
- [Wasabi](https://plume.arunprakashg.com/docs/providers/wasabi/)
- [MinIO](https://plume.arunprakashg.com/docs/providers/minio/)
- [Any S3-compatible API](https://plume.arunprakashg.com/docs/providers/s3-compatible/)

## How it works

1. Connect a bucket. Pick a provider, paste your keys and test the connection from the setup wizard.
2. Offload your library. New uploads go to storage automatically. Existing files move in a bulk job you can pause and resume.
3. Serve from the edge. URLs in posts and metadata point to your bucket or CDN domain, and caches are purged for you.

## Features

- Bulk migration: move thousands of existing files in the background. Pause, resume and retry failures.
- Restore any time: pull files back to your server and revert URLs, one attachment or the whole library.
- Cache purge: Cloudflare, LiteSpeed, WP Fastest Cache and proxy caches are cleared after each change.
- Page builders: URLs stored by Elementor, Slider Revolution, Smart Slider 3 and NextGEN Gallery are rewritten too.
- WooCommerce downloads: protected product files are delivered through short-lived signed storage URLs.
- Multisite: a network admin panel with offload totals for every site.
- WP-CLI: offload, rewrite, revert and download from the terminal. See [WP-CLI](https://plume.arunprakashg.com/docs/reference/wp-cli/).

## Questions

### Are local files deleted after offloading?

No. Local copies stay on your server unless you turn on Remove local copies. You can restore files from storage at any time.

### Can I use my own CDN domain?

Yes. Set a custom domain such as media.example.com and Plume builds every media URL with it, so files are served through your CDN.

### What happens if I deactivate Plume?

Scheduled jobs stop and your settings are kept. Files already in your bucket stay there. If you removed local copies, restore them first so your server can serve the Media Library on its own.

### Does Plume send any data to you?

No. There is no license server and no telemetry. Your site talks only to the storage provider and cache services you configure.
