Skip to main content

Getting Started

Install mod_pagespeed 1.1 on nginx, Apache, IIS, or Envoy. Quick setup, 14-day free trial.

Choose your platform

mod_pagespeed 1.1 runs on nginx, Apache, IIS, and Envoy. Pick your web server below.

nginx

Install the dynamic module alongside your existing nginx (1.26.x stable or 1.27.x mainline):

# Copy the module to nginx modules directory
sudo cp ngx_pagespeed_module.so /usr/lib/nginx/modules/

# Add to nginx.conf (top-level, before http block)
load_module modules/ngx_pagespeed_module.so;

Then enable it in your server block:

server {
    pagespeed on;
    pagespeed FileCachePath /var/cache/pagespeed;

    # Your existing configuration...
}

Reload nginx:

sudo nginx -t && sudo systemctl reload nginx

Apache

Replace the open-source module with the 1.1 build:

# Replace the existing module
sudo cp mod_pagespeed.so /usr/lib/apache2/modules/

# Restart Apache
sudo systemctl restart apache2

Your existing pagespeed.conf continues to work — no configuration changes needed.

IIS

Download the IIS module installer from the downloads page and run it on your Windows Server. The installer registers the module in IIS automatically.

Envoy

Add the mod_pagespeed HTTP filter to your Envoy configuration. Envoy integration is currently in beta — contact us for setup guidance.

Verify it works

Send a request and check for the X-PageSpeed header:

curl -I http://localhost/

You should see:

X-PageSpeed: 1.1.0

The first request to any URL will show X-PageSpeed: MISS while resources are being optimized. Subsequent requests will show X-PageSpeed: HIT.

License activation

mod_pagespeed 1.1 includes a 14-day free trial. No credit card required to start.

To activate a subscription after the trial, visit modpagespeed.com/pricing/ and choose a plan. You’ll receive setup instructions by email.

Next steps