Cloud Backup

Cloud Backup stores your original images on an external storage provider before they're optimized, so you can always restore to the uncompressed version — even if the local backup is deleted.

Supported Providers

• Google Drive
• Dropbox

Both connect via OAuth — you'll create an app in the provider's developer console, then authorize Compresso to access your account.

Connecting Google Drive

Step 1: Create a Google Cloud Project

1. Go to the Google Cloud Console
2. Create a new project (or select an existing one)
3. Go to APIs & Services > Library
4. Search for Google Drive API and click Enable

Step 2: Create OAuth Credentials

1. Go to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Web application as the application type
4. Under Authorized redirect URIs, add:

   https://yoursite.com/wp-admin/admin.php?page=compresso&compresso_oauth_callback=1

   Replace yoursite.com with your actual domain.
5. Click Create
6. Copy the Client ID and Client Secret

Step 3: Connect in Compresso

1. Go to Compresso > Cloud Backup
2. Select Google Drive as your provider
3. Paste your Client ID and Client Secret
4. Click Connect
5. You'll be redirected to Google's consent screen — sign in and grant access
6. After approval, you'll be redirected back to Compresso with a success message

Once connected, you'll see the email address of the connected Google account.

Connecting Dropbox

Step 1: Create a Dropbox App

1. Go to the Dropbox App Console
2. Click Create app
3. Choose Scoped access
4. Choose Full Dropbox access
5. Give your app a name (e.g., "Compresso Backup")
6. Click Create app

Step 2: Configure the App

1. In your app's Settings tab, find the OAuth 2 section
2. Under Redirect URIs, add:

   https://yoursite.com/wp-admin/admin.php?page=compresso&compresso_oauth_callback=1

   Replace yoursite.com with your actual domain.
3. Copy the App key (this is your Client ID) and App secret (this is your Client Secret)

Step 3: Connect in Compresso

1. Go to Compresso > Cloud Backup
2. Select Dropbox as your provider
3. Paste your App key as the Client ID and App secret as the Client Secret
4. Click Connect
5. You'll be redirected to Dropbox's authorization page — sign in and grant access
6. After approval, you'll be redirected back to Compresso

Configuring Backup Settings

Once connected, configure how backups work:

Backup Folder

Set the Remote Path to control where backups are stored in your cloud storage. The default is /Compresso Backups. Compresso preserves your uploads folder structure inside this path (e.g., /Compresso Backups/2024/12/image.jpg).

Auto Backup

Enable Auto Backup to automatically upload the original image to the cloud before each optimization. This works with:

• Single image optimizations
• Bulk optimization runs
• Auto-optimize on upload

The upload happens in the background via Action Scheduler, so it won't slow down the optimization process.

Scheduled Backups

Enable Scheduled Backups to periodically back up any originals that haven't been uploaded yet. This catches any images that may have been missed by auto backup.

• Frequency — Daily or Weekly
• Day — If weekly, which day of the week
• Time — What time to run the backup

Running a Manual Backup

Click Backup Now to immediately start backing up all unbacked-up originals. A progress bar shows the current status:

• Total — How many images need backing up
• Processed — How many have been uploaded so far
• Failed — Any uploads that failed (you can retry later)

You can cancel a running backup at any time. Images already uploaded will remain in the cloud.

Restoring from Cloud

1. Go to Compresso > Cloud Backup
2. Click Manage Backups
3. Search for or browse to the image you want to restore
4. Click Restore

The original image is downloaded from the cloud and replaces the optimized version on your server. The image's optimization data is cleared, so it can be re-optimized with different settings if needed.

Managing Cloud Storage

From the Manage Backups modal you can:

• Search for specific images by filename
• Delete individual backups you no longer need
• Bulk delete — select multiple backups and delete them at once
• View file sizes and backup dates for each image

Activity Log

The activity log at the bottom of the Cloud Backup page shows recent backup activity — successful uploads, errors, and schedule runs. This is useful for verifying that automatic backups are working correctly.

Disconnecting

To disconnect your cloud account:

1. Click Disconnect next to your connected email
2. Confirm the disconnection

This removes the stored tokens from your site. Existing backups in your cloud storage are not deleted — they remain in your Google Drive or Dropbox account.

Troubleshooting

"Connect" button doesn't redirect. Make sure your Client ID and Client Secret are entered correctly. Check that the redirect URI in your provider's developer console exactly matches your site URL, including https://.

Backups are failing. Check the activity log for error details. Common causes: expired tokens (disconnect and reconnect), insufficient cloud storage space, or server memory limits for large files.

Scheduled backups aren't running. Verify that Action Scheduler is working — go to Tools > Scheduled Actions and check for compresso_scheduled_cloud_backup entries. Also confirm your WordPress timezone is set correctly.