mod_pagespeed is an Apache 2.x module. It is added into an existing Apache installation, and configured with the pagespeed.conf configuration file.

Table of Contents

• Installing From Packages
• Installing From Source
  • Prerequisites
  • Checking Out The Code
  • Running Tests
  • Compilation
  • Installation
  • Updating
  • Building Binary Packages
  • Debugging CSS Issues
  • Standalone JS Minification
  • Installation On Other Platforms
• Module Configuration
  • Enabling the Module
  • Configuring Handlers
  • Setting up the Output Filter
  • Respecting Vary Headers
  • Turning the module on and off
  • Lower-casing HTML names
  • Preserving HTML caching headers
  • .htaccess files and Directory scopes
  • Support for Apache 2.4.x
  • Specifying the value for the X-Mod-Pagespeed header
  • Using mod_pagespeed With Virtual Hosts
• Configuring Filters
  • Configuring the Rewriting Level
  • Enabling and Disabling Specific Filters
  • Forbidding All Disabled Filters
  • Tuning the Filters
• Authorizing and Mapping Domains
  • Authorizing Domains
  • Mapping Origin Domains
  • Mapping Rewrite Domains
  • Sharding Domains
  • Mapping Proxy Domains
  • Fetch Server Restrictions
  • URL valued attributes
  • Loading Static Files From Disk
• URL Control
  • Restricting Rewriting Via Wildcards
  • Combining Resources Across Paths
  • Limiting the maximum generated URL segment length
  • Limiting the maximum size of a resource to optimize
  • Restricting rewriting URLs of introspective JavaScript
• HTTPS Support
  • Map the origin domain
  • Load static files from disk
  • Rewrite domains
  • Shard domains
  • Respecting X-Forwarded-Proto
  • Risks
  • SPDY-specific configuration
• System Integration
  • Configuring Caching
    • Configuring Server-Side Cache for mod_pagespeed
    • Configuring the File Cache
    • Configuring the in-memory LRU cache
    • Using memcached for scalable networked caching
  • Flushing Server-Side Cache
  • Configuring Shared Memory for Locks
  • Setting the URL fetcher timeout
  • Setting the rewrite deadline per flush window
  • Fetching Resources using Gzip
  • Tuning Threading
  • Limiting the number of concurrent image optimizations
  • Limiting the size of HTML parsed
• Experimenting with mod_pagespeed
  • Per-request configuration
  • Configuring mod_pagespeed_examples
  • Trying out mod_pagespeed using mod_proxy
  • Experimental Framework
  • Run A/B experiments using live traffic
• Security Considerations
  • Untrusted Content
  • Private Content
• Release Notes
  • Release 1.2.24.1-beta
  • Release 1.1.23.2-stable
  • Release 1.1.23.2-beta
  • Release 1.1.23.1-beta
  • Release 1.0.22.7-stable
  • Release 0.10.22.7
  • Release 0.10.22.6
  • Release 0.10.22.4
  • Release 0.10.21.2
  • Release 0.10.19.5
  • Release 0.10.19.3
  • Release 0.9.18.6
  • Release 0.9.17.6
  • Release 0.9.17.3
  • Release 0.9.16.9
  • Release 0.9.16.3
  • Release 0.9.15.3
  • Release 0.9.14.6
  • Release 0.9.11.5
  • Release 0.9.11.3
  • Release 0.9.8.1-250
  • Release 0.9.8.1-215
  • Release 0.9.1.1-171
• FAQ
  • When will you support my favorite OS, http server, or protocol?
  • Do you support SUSE?
  • Why isn't mod_pagespeed rewriting any of my pages?
  • I'm using WordPress and my pages are blank. Why?
  • I installed Apache 2.2 using cPanel, and can't get mod_pagespeed to work when I install from the .deb or .rpm
  • mod_pagespeed broke my site; what do I do?
  • mod_pagespeed does not pick up changes when I edit css or javascript files
  • Why is mod_pagespeed giving me errors in jquery or js_tinyMCE?
  • What's with all these "Serf" errors in my logs? Error status=670003 (Temporary failure in name resolution)
  • Can I move mod_pagespeed's file-based cache into RAM?
  • Why don't you allow source-installs via ./configure && make?
  • Why is my Google Analytics data being inflated by "Serf"?
  • mod_pagespeed does not rewrite pages produced from mod_php
  • mod_pagespeed causes my page to display an XML Parsing Error message
  • Why do I get Permission denied errors in my log file on CentOS, RHEL, or any system using SELinux?