CloudSync Master - WordPress Media Offloading Plugin

About CloudSync Master

CloudSync Master is a WordPress plugin that offloads media files to cloud storage providers and serves them via CDN. It is purpose-built for speed and efficiency:

Ultra-small footprint - Under 1.5 MB (10-40x smaller than competitors like WP Offload Media at 23 MB or Media Cloud at 87 MB)
Native REST APIs - No bundled AWS/Google SDKs; uses direct HTTP calls for minimal overhead
10 cloud providers - S3, Cloudflare R2, Google Cloud, DigitalOcean Spaces, Backblaze B2, Wasabi, Vultr, Linode, MinIO, and any S3-compatible endpoint
Async queue-based uploads (PRO) - Non-blocking background processing via WP-Cron with concurrent uploads

Availability

Free version: Available on WordPress.org - 1 account, 10 providers, setup wizard, settings page (performance options disabled), immediate uploads via hooks (no queue/cron), competitor migration via admin UI, basic CLI (
```
status
```
,
```
accounts list
```
,
```
sync
```
report-only)
PRO version (requires activated license): Purchase at https://1teamsoftware.com/product/cloudsync-master-pro/ - unlimited accounts, async queue with background cron processing, objects browser, concurrent uploads (1-20 via admin UI, 1-10 via CLI), Google OAuth, WooCommerce/EDD signed URLs, image optimizer integrations, CSS/JS offloading, full CLI management (all commands), competitor migration via CLI, priority support

Installation

If CloudSync Master is not installed on the target WordPress site:

bash

# Install and activate the free version from WordPress.org
wp plugin install wp-cloudsync-master --activate

# For PRO: download from https://1teamsoftware.com/product/cloudsync-master-pro/
# then upload and activate
wp plugin install /path/to/wp-cloudsync-master-pro.zip --activate

CLI Command Overview

All commands follow:

wp cloudsync <command> [<subcommand>] [--flags]

Command	Description	Version
`status`	Show sync status across all accounts	Free (basic) / PRO (with queue info)
`sync`	Scan media library for unsynced files	Free (report only) / PRO (queues files)
`accounts list`	List configured accounts	Free
`accounts add/update/delete/activate/test/info`	Full account management	PRO
`queue`	Manage upload queue (status/list/clear/process)	PRO
`settings`	Manage plugin settings (list/get/set/reset)	PRO
`integrations`	Manage plugin integrations (list/enable/disable/set)	PRO
`objects`	Manage synced object records (list/reupload/delete)	PRO
`license`	Manage PRO license (status/activate/deactivate)	PRO (always available, even before activation)
`config`	Show configuration sources and generate wp-config.php snippets	PRO
`migrate`	Detect and import from competitor plugins	PRO

PRO CLI commands require the PRO plugin with an activated license. Without activation, only free commands and

license

(activate/deactivate/status) are available.

For the complete CLI reference with all flags and examples, read

references/cli_reference.md

Common Workflows

Initial Setup (from scratch)

bash

# 1. Activate PRO license (always available in PRO, even before first activation)
wp cloudsync license activate XXXX-XXXX-XXXX-XXXX

# 2. Add cloud storage account
wp cloudsync accounts add \
  --provider=cloudflare_r2 \
  --name="Production R2" \
  --bucket=my-media \
  --access-key-id=$R2_ACCESS_KEY \
  --secret-access-key=$R2_SECRET_KEY \
  --region=auto \
  --api-endpoint=https://$R2_ACCOUNT_ID.r2.cloudflarestorage.com \
  --custom-domain=cdn.example.com \
  --activate

# 2b. Test the connection
wp cloudsync accounts test --account=<account-id>

# 3. Configure upload behavior
wp cloudsync settings set createObjectOnFileUpload yes
wp cloudsync settings set rewriteFileUrlWithObjectUrl yes
wp cloudsync settings set uploadBatchSize 25
wp cloudsync settings set uploadConcurrency 3

# 4. Sync existing media library
wp cloudsync sync --batch-size=100

# 5. Verify
wp cloudsync status --format=json

Provider-Specific Account Setup

Cloudflare R2 (zero egress fees):

bash

wp cloudsync accounts add \
  --provider=cloudflare_r2 --name="R2 Storage" --bucket=my-bucket \
  --access-key-id=KEY --secret-access-key=SECRET \
  --region=auto --api-endpoint=https://ACCOUNT_ID.r2.cloudflarestorage.com \
  --custom-domain=cdn.example.com --activate
wp cloudsync accounts test --account=<account-id>

AWS S3:

bash

wp cloudsync accounts add \
  --provider=s3 --name="AWS Media" --bucket=my-s3-bucket \
  --access-key-id=KEY --secret-access-key=SECRET \
  --region=us-east-1 --activate
wp cloudsync accounts test --account=<account-id>

Google Cloud Storage (service account):

bash

wp cloudsync accounts add \
  --provider=google --name="Google Media" --bucket=my-gcs-bucket \
  --auth-type=service_account --key-file=/path/to/service-account.json \
  --activate
wp cloudsync accounts test --account=<account-id>

DigitalOcean Spaces:

bash

wp cloudsync accounts add \
  --provider=digitalocean --name="DO Spaces" --bucket=my-space \
  --access-key-id=KEY --secret-access-key=SECRET \
  --region=nyc3 --api-endpoint=https://nyc3.digitaloceanspaces.com \
  --activate
wp cloudsync accounts test --account=<account-id>

Monitoring and Health Checks

bash

wp cloudsync status --format=json      # Quick status
wp cloudsync queue status              # Check queue backlog
wp cloudsync queue process             # Force-process stuck queue
wp cloudsync objects list --per-page=10 # List recently synced objects
wp cloudsync license status            # Verify license

Migration from Competitor Plugin

bash

wp cloudsync migrate detect                      # Detect installed competitors
wp cloudsync migrate import --from=wp-offload-media  # Import settings
wp cloudsync accounts test --account=<imported-id>   # Verify imported account

Hardened Configuration (wp-config.php)

bash

wp cloudsync config generate --account=<id>  # Generate define() snippet
wp cloudsync config show                     # Show all config sources

Configuration priority: environment variables > wp-config.php constants > database.

Key Settings Reference

Setting	Type	Default	Description
`createObjectOnFileUpload`	bool	no	Upload to cloud on media upload
`rewriteFileUrlWithObjectUrl`	bool	no	Replace local URLs with cloud URLs
`deleteObjectOnFileDelete`	bool	no	Delete from cloud when local file deleted
`deleteFileAfterObjectCreated`	bool	no	Remove local file after cloud upload
`createObjectsForExistingFiles`	bool	no	Queue existing media library for upload
`uploadBatchSize`	int	10	Files per upload batch (1-100)
`uploadConcurrency`	int	1	Concurrent uploads (1-10 via CLI, 1-20 via admin UI)
`enableSignedDownloads`	bool	no	Generate signed URLs for downloads
`signedUrlExpirySeconds`	int	3600	Signed URL lifetime in seconds (120-604800)
`fallbackToLocalOnMissingRemote`	bool	yes	Serve local file if cloud file missing

Run

wp cloudsync settings list

for the complete list with min/max constraints.

Supported Providers

Provider	ID	Auth	Notes
Amazon S3	`s3`	Access Key + Secret	Industry standard
Cloudflare R2	`cloudflare_r2`	Access Key + Secret	Zero egress fees
Google Cloud Storage	`google`	Service Account JSON or OAuth	Enterprise-grade
DigitalOcean Spaces	`digitalocean`	Access Key + Secret	S3-compatible
Backblaze B2	`backblaze`	Access Key + Secret	Cost-effective
Wasabi	`wasabi`	Access Key + Secret	No egress fees
Vultr Object Storage	`vultr`	Access Key + Secret	S3-compatible
Linode Object Storage	`linode`	Access Key + Secret	S3-compatible
MinIO	`minio`	Access Key + Secret	Self-hosted
Custom S3-Compatible	`s3_compatible`	Access Key + Secret	Any S3 endpoint

Supported Competitor Migrations

Plugin	Migration ID
WP Offload Media	`wp-offload-media`
Media Cloud	`media-cloud`
Media Cloud Sync	`media-cloud-sync`
WP Stateless	`wp-stateless`

Environment Variable Configuration

bash

# S3-compatible account (individual fields)
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_ACCESS_KEY_ID=key
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_SECRET_ACCESS_KEY=secret
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_BUCKET=my-bucket
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_ENDPOINT=https://endpoint.com
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_REGION=auto
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_S3_PATH_PREFIX=wp-content/uploads

# Google Cloud Storage account (individual fields)
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_GCS_SERVICE_ACCOUNT_KEY='{"type":"service_account",...}'
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_GCS_BUCKET=my-gcs-bucket
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_GCS_PATH_PREFIX=wp-content/uploads

# Full account definitions (JSON array, supports multiple accounts)
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_ACCOUNTS='[{"provider":"cloudflare_r2","bucketName":"my-bucket",...}]'

# License key
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_LICENSE_KEY=your-license-key

# Plugin settings (JSON)
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_SETTINGS='{"uploadBatchSize":25}'

# Disable UI account management (external-only mode)
ONETEAMSOFTWARE_CLOUDSYNC_MASTER_DISABLE_ACCOUNT_MANAGEMENT=true

Resources

references/

Detailed CLI reference with every command, subcommand, flag, and example:

```
references/cli_reference.md
```
- Complete
```
wp cloudsync
```
CLI reference

wp-cloudsync-master

NPX Install

Tags

SKILL.md Content

CloudSync Master - WordPress Media Offloading Plugin

About CloudSync Master

Availability

Installation

CLI Command Overview

Common Workflows

Initial Setup (from scratch)

Provider-Specific Account Setup

Monitoring and Health Checks

Migration from Competitor Plugin

Hardened Configuration (wp-config.php)

Key Settings Reference

Supported Providers

Supported Competitor Migrations

Environment Variable Configuration

Resources

references/