Wasabi

This guide walks you through connecting Sunshine Cloud Storage to Wasabi. Wasabi is an S3-compatible storage provider known for low pricing and no egress (download) fees.

What You Need

• A Wasabi account
• A storage bucket
• An access key and secret key

Step 1: Create a Bucket

In the Wasabi Console, go to Buckets and click Create Bucket. Choose a name and a region. Wasabi has data centers in the US, Europe, Asia Pacific, and Canada.

For full details, see Wasabi's documentation on creating buckets.

Step 2: Create Access Keys

Go to Access Keys in the Wasabi Console and create a new key pair. Save both the Access Key and Secret Key — the secret key is only shown once.

If you prefer more granular control, you can create a sub-user with a policy that only grants access to your specific bucket.

For full details, see Wasabi's documentation on access keys.

Step 3: Connect in Sunshine

1. Go to Sunshine Photo Cart > Settings > Cloud Storage.
2. Select Wasabi as the provider.
3. Choose your connection method:
4. Database — Enter your Access Key and Secret Key directly in the settings.
5. wp-config.php (recommended) — Add the provided code snippet to your wp-config.php file.
6. Select the Region that matches where your bucket was created.
7. Enter your bucket name, or click Load Buckets to select one.
8. Click Test Connection to verify everything works.

wp-config.php Example

define( 'SUNSHINE_CLOUD_STORAGE_SETTINGS', serialize( array(
    'provider'          => 'wasabi',
    'access-key-id'     => 'YOUR_WASABI_ACCESS_KEY',
    'secret-access-key' => 'YOUR_WASABI_SECRET_KEY',
    'bucket'            => 'my-bucket-name',
    'region'            => 'us-east-1',
) ) );

Learn how to add this custom code to your WordPress website

Set the region value to match where your bucket was created. Available regions include us-east-1, us-east-2, us-west-1, us-west-2, us-central-1, eu-central-1, eu-central-2, eu-south-1, eu-west-1, eu-west-2, eu-west-3, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, and ca-central-1.

CORS Configuration

If images aren't loading in the WordPress admin but work fine on the frontend of your site, your bucket likely needs CORS (Cross-Origin Resource Sharing) headers. This allows the browser to load images from Wasabi when you're managing galleries in WordPress.

In the Wasabi Console, go to your bucket > Properties > CORS Configuration and add:

[
  {
    "AllowedOrigins": ["*"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedHeaders": ["*"],
    "MaxAgeSeconds": 86400
  }
]

Learn how to add this custom code to your WordPress website

Using * for origins is safe here since these are publicly accessible images.

Troubleshooting

Region mismatch errors

Make sure the region you select in Sunshine matches where your bucket was created in the Wasabi Console. If the regions don't match, you'll see connection errors.

Access denied

Verify your access key has read and write permissions on the bucket. If using a sub-user, make sure the IAM policy includes s3:PutObject, s3:GetObject, s3:DeleteObject, s3:ListBucket, and s3:GetBucketLocation.