---
title: "Connecting Your Cloud Storage (Setup Wizard)"
url: "https://dudlewebs.com/guideline/media-cloud-sync/getting-started/connecting-your-cloud-storage-setup-wizard/"
markdown_url: "https://dudlewebs.com/guideline/media-cloud-sync/getting-started/connecting-your-cloud-storage-setup-wizard.md"
type: "Docs"
language: "en-US"
date_published: "2026-11-08T09:51:10+00:00"
date_modified: "2026-11-08T14:27:08+00:00"
---

# Connecting Your Cloud Storage (Setup Wizard)

The setup wizard connects Media Cloud Sync to your cloud storage in five stages, shown in the panel on the left: **Welcome → Choose Provider → Connect → Save → Delivery**. The **Connect** stage has its own steps: **Credentials, Bucket, Permissions**, and, on Amazon S3 and Google Cloud Storage, **Security**.

This guide covers the wizard steps that are the same for every provider. For the provider-side preparation (creating keys and buckets), follow the guide for your provider:

- [Amazon S3](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/quick-start-amazon-web-services-aws-s3/)
- [Google Cloud Storage](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/quick-start-google-cloud-storage/)
- [DigitalOcean Spaces](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/quick-start-digitalocean-spaces/)
- [Cloudflare R2](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/quick-start-cloudflare-r2/)
- [S3-Compatible Storage](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/configure-s3-compatible-object-storage-2/)

> **Tip:** Get your access keys and bucket ready in your provider’s console **before** starting the wizard.

## Open the wizard

Go to **Media Cloud Sync → Dashboard**. On a new install, the **Storage** card shows **Connect to cloud**. Click **Configure**. You can also click **Get Started** under the plugin name on the **Plugins** screen.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-01-dashboard-unconfigured-1024x882.png)

Every wizard screen has **Exit to Dashboard** at the top, and a **Need a hand?** box with a link to your provider’s guide.

## Step 1: Welcome

The welcome screen summarizes what the wizard will do. Click **Get started**.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-02-welcome-1024x882.png)

## Step 2: Choose your provider

Select the cloud service you want to use:

- **Amazon S3**
- **Google Cloud Storage**
- **Digital Ocean Spaces**
- **Cloudflare R2**
- **S3 Compatible** (Wasabi, Backblaze B2, MinIO, Linode/Akamai Object Storage, and others)

If you choose **S3 Compatible**, also enter a **Provider label** (for example “Wasabi”). This name is shown throughout the plugin.

Click **Next**.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-03-choose-provider-1024x882.png)

## Step 3: Enter credentials

First choose where the plugin should read your credentials from:

| Option | What it does |
| --- | --- |
| **Use wp-config.php Constant** *(Recommended)* | Keeps your keys out of the database. You add a `WPMCS_CONFIG` constant to `wp-config.php`, and the plugin reads it on the server. Keys are never sent to the browser. |
| **Store in Database** | Enter your keys directly in the form. Simplest option; the keys are saved in the WordPress database and masked in the admin screens. |

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-04-credential-source-1024x882.png)

**If you chose “Store in Database”**, fill in the fields for your provider:

| Provider | Fields |
| --- | --- |
| Amazon S3 | Access Key, Secret Key, Region |
| Google Cloud Storage | JSON Config File (service account key) |
| DigitalOcean Spaces | Access Key, Secret Key, Region |
| Cloudflare R2 | Account ID, Data Jurisdiction / Region, Access Key, Secret Key |
| S3 Compatible | Storage Endpoint, Access Key, Secret Key, Region |

**If you chose “Use wp-config.php Constant”**, the wizard shows a ready-made snippet for your provider. Use the **Copy** button, paste it into `wp-config.php` above the `/* That's all, stop editing! */` line, and replace the placeholder values. For providers with a region, pick your region in the wizard and copy its value from there. See [Storing Credentials in wp-config.php](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/storing-credentials-in-wp-config-php/) for all snippets.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-05-credentials-1024x882.png)

Click **Verify credentials**. The plugin connects to your provider and checks that the credentials are valid.

## Step 4: Choose or create a bucket

Pick the bucket (on DigitalOcean, the **Space**) that should hold your media:

- **Use existing Bucket**: use **Select from list** to pick one, or **Enter manually** to type its name. Use **Enter manually** if your keys aren’t allowed to list buckets.
- **Create new Bucket**: enter a new bucket name (and a region, on Google Cloud Storage). The plugin creates the bucket for you.

> On **DigitalOcean Spaces**, type the Space name rather than picking from a list. On **S3 Compatible** storage, type the bucket name; creating a new bucket from the wizard isn’t available for S3-compatible providers.

Bucket names must be 3–63 characters long and use lowercase letters, numbers, hyphens, and dots.

**Amazon S3 only:** turn on **Use Transfer Acceleration** if you have enabled S3 Transfer Acceleration on that bucket.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-06-bucket-1024x882.png)

Click **Verify bucket**.

## Step 5: Permission check

The plugin runs a live permission test on your bucket:

1. **Checking Bucket exists**: confirms the bucket exists and can be read.
2. **Checking write permissions**: uploads a small test file.
3. **Checking delete permissions**: deletes that test file.

Every check must pass to continue. If one fails, go **Back** and fix the permissions for your key or bucket (see [Troubleshooting](https://dudlewebs.com/guideline/media-cloud-sync/sync-and-maintenance/troubleshooting-and-faq/)).

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-07-verify-permissions-1024x882.png)

## Step 6: Bucket security (Amazon S3 and Google Cloud Storage only)

These settings change the bucket itself. Their current values are loaded from your account.

| Provider | Option | Recommendation |
| --- | --- | --- |
| Amazon S3 | **Block All Public Access** | Keep **off** if you serve media straight from S3. Turn on only if you deliver through a CDN such as CloudFront that has its own access to the bucket. |
| Amazon S3 | **Enforce Object Ownership** | Keep **off** unless you deliver through CloudFront and know you need it. |
| Google Cloud Storage | **Block All Public Access** | Enforces Public Access Prevention on the bucket. Keep **off** when serving directly from GCS. Don’t combine with Private Media. |

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-08-security-1024x882.png)

Click **Next**.

## Step 7: Save

The wizard confirms that it’s connected and shows the connection for you to review. Click **Save and continue**.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-09-save-1024x882.png)

## Step 8: Choose how media is delivered

After saving, you’re taken to **Choose how media is delivered**. This decides which URL your media is served from:

- **Your storage provider itself** (for example *Amazon S3*): files are served straight from the bucket URL.
- **A named CDN**: Amazon CloudFront, Bunny.net, Fastly, Cloudflare CDN, Akamai, KeyCDN, Gcore, Leaseweb CDN, or CDNetworks.
- **Other**: any other CDN or custom domain. Enter a **Provider Name**.

Each card has tags: **Fast** or **Slow**, and **Private media** `PRO` where that option supports it.

![](https://dudlewebs.com/wp-content/uploads/2026/11/wizard-10-choose-delivery-1024x882.png)

Select a card and click **Finish setup**, or click **Skip for now** to choose later. See [Delivery Settings and CDN](https://dudlewebs.com/guideline/media-cloud-sync/settings/delivery-settings-and-cdn/) for setting up a custom domain.

## You’re connected

New uploads to the Media Library are now copied to your bucket automatically. Next:

1. Review your [Storage Settings](https://dudlewebs.com/guideline/media-cloud-sync/settings/storage-settings-reference/).
2. Upload a test image and check that its URL points to the cloud.
3. [Sync your existing media](https://dudlewebs.com/guideline/media-cloud-sync/sync-and-maintenance/syncing-existing-media-to-the-cloud/) to the cloud.

Already have media in the bucket, or moving from another offload plugin? See [Importing Existing Cloud Media](https://dudlewebs.com/guideline/media-cloud-sync/pro-tools/importing-existing-cloud-media/) `PRO` first.

## Changing provider or bucket later

On **Media Cloud Sync → Settings**, click **Change** on the **Storage** card to run the wizard again.

> **Warning:** Changing the provider or bucket does **not** move files that are already in the old bucket. To copy them across, use **Migrate Bucket to Bucket** `PRO`.

[← Previous Installing and Activating Media Cloud Sync](https://dudlewebs.com/guideline/media-cloud-sync/getting-started/installing-and-activating-media-cloud-sync/) [Next → Quick Start: Amazon Web Services (AWS S3)](https://dudlewebs.com/guideline/media-cloud-sync/storage-providers/quick-start-amazon-web-services-aws-s3/)

Still need help?

[Chat with us Quick questions, answered live](https://dudlewebs.com/contact/) [Contact us Sales, partnerships or anything else](https://dudlewebs.com/contact/) [Create a ticket Technical issues with your site](https://dudlewebs.com/submit-ticket/)
