Black Friday Deal Active Get Clockwork Offloader Pro for $1.00 for your entire 1st year (Save up to $249). Claim $1 Access
Home / Docs / Getting Started / Installation & Setup
Getting Started

Installation & Setup

Step-by-step instructions for installing Clockwork Offloader Lite or Pro, activating your license key, and setting up wp-config constants.

System Requirements

  • PHP: 8.2 or higher (PHP 7.4, 8.0, and 8.1 have reached End-of-Life and are not supported)
  • WordPress: 6.2 or higher (Full WordPress Multisite network support)
  • PHP Extensions: curl, json, mbstring, simplexml
  • Cloud Storage: Amazon S3 bucket credentials (production-tested), or S3-compatible storage (Cloudflare R2, Google Cloud, DigitalOcean Spaces, Wasabi, Backblaze B2, MinIO — beta testers welcome!)
Why PHP 8.2+? Clockwork Offloader is written with modern PHP features (typed properties, readonly classes, intersection types, and modern cloud SDKs) to ensure maximum throughput, minimal memory footprint, and zero legacy deprecation warnings.

Installing Clockwork Offloader Pro

Once you purchase a license from our Pricing page, you will receive an instant download link for clockwork-offloader-pro.zip along with your unique license key.

Method 1: WordPress Admin Upload

  1. Log in to your WordPress Dashboard and navigate to Plugins → Add New → Upload Plugin.
  2. Click Choose File and select clockwork-offloader-pro.zip.
  3. Click Install Now, then click Activate Plugin.
  4. Navigate to Settings → Clockwork Offloader.
  5. Click the License tab, paste your License Key, and click Activate License.
1-Year Access & Updates: Your license key unlocks seamless one-click in-dashboard updates from our CDN for the duration of your active subscription.

Method 2: Command Line (WP-CLI)

If you manage servers via SSH or automation tools like Ansible or SpinupWP:

# Install and activate via WP-CLI
wp plugin install /path/to/clockwork-offloader-pro.zip --activate

# On WordPress Multisite Networks
wp plugin install /path/to/clockwork-offloader-pro.zip --activate-network

Securing Credentials with wp-config.php

While you can enter your AWS Access Key and Secret Key into the WordPress admin UI, storing them in your wp-config.php file is strongly recommended for security and version-controlled environments:

/**
 * Clockwork Offloader Configuration
 */
define( 'CLOCKWORK_OFFLOADER_KEY', 'AKIAIOSFODNN7EXAMPLE' );
define( 'CLOCKWORK_OFFLOADER_SECRET', 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY' );
define( 'CLOCKWORK_OFFLOADER_BUCKET', 'your-media-bucket-name' );
define( 'CLOCKWORK_OFFLOADER_REGION', 'us-east-2' );
define( 'CLOCKWORK_OFFLOADER_DOMAIN', 'media.yourdomain.com' ); // CloudFront CNAME
Multisite Tip: Setting these constants in wp-config.php automatically protects your credentials from subsite administrators and guarantees that every network subsite uses the exact same storage bucket and CDN configuration.