Documentation
v2.0.19Two products, one optimization core. Pick the documentation that matches your deployment.
Out-of-process worker
ModPageSpeed 2.0 docs
The async worker behind an nginx reverse proxy, or ASP.NET Core middleware. Docker, configuration, deployment, and troubleshooting.
In-process module
mod_pagespeed 1.15 docs
The native module for Apache, nginx, and IIS. Install, the classic filter set, per-filter configuration, and the built-in admin console.
ModPageSpeed 2.0 documentation
Start here
Getting Started
Install ModPageSpeed 2.0. Two integrations share one optimization pipeline: a Docker / nginx reverse proxy, or ASP.NET Core middleware.
Install
Install with Docker
Deploy ModPageSpeed 2.0 using Docker containers.
Install the nginx module
Install the ModPageSpeed 2.0 dynamic module into your existing nginx.
Deploy with Helm
Deploy ModPageSpeed 2.0 on Kubernetes with the official Helm chart.
Activate your license
Activate your ModPageSpeed 2.0 license key on nginx and the worker.
Configure
mod_pagespeed configuration: nginx directives and worker flags
Reference for ModPageSpeed 2.0 nginx directives, worker flags, and cache tuning. Looking for the mod_pagespeed 1.15 reference? See /1.1/docs/configuration/.
Set Cache-Control headers
Set the right Cache-Control headers on your origin for optimal caching with ModPageSpeed 2.0.
Choose a cache mode
Control how ModPageSpeed sets Cache-Control headers on optimized responses. Safe mode (default) prioritizes quick recovery; aggressive mode prioritizes cache efficiency.
Integrate with a CDN
Deploying ModPageSpeed behind a CDN: Vary header strategies, per-CDN recommendations, and cache key configuration.
Operate
Deploy to production (Docker / nginx)
Production deployment guide for ModPageSpeed 2.0.
Use the web console
Use the ModPageSpeed 2.0 web console to inspect cache state, monitor performance, and tune configuration.
Analyze pages with headless Chrome
How ModPageSpeed 2.0 uses headless Chrome to extract critical CSS, detect LCP, and validate optimizations.
Troubleshoot common issues
Diagnose and fix common ModPageSpeed 2.0 issues.
ASP.NET Core
Install ASP.NET Core middleware
Install ModPageSpeed as ASP.NET Core middleware via NuGet. Same optimization pipeline, no nginx required.
Configure ASP.NET Core middleware
Configuration reference for ModPageSpeed ASP.NET Core middleware. appsettings.json options, hot reload, environment variables, and common patterns.
Run in production
Production deployment guide for the ModPageSpeed 2.0 ASP.NET Core middleware: secret management, health probes, license enforcement, multi-instance scale, and zero-downtime restarts.