Installation

Installing IIS WebSpeed

Extract the contents of the zip file and run install.cmd with administrative priviliges.
Warning: installing IIS WebSpeed will reset the application pools. Current sessions will be lost.

Add license key

If you have bought a license key follow the registration steps to unlock all features and remove the "powered by IIS WebSpeed" banner.

Validate file cache path

Head over to iispeed.config in the installation directory to validate the configured FileCachePath. By default iispeed.config will point to c:\iispeed\cache, and the installer will attempt to create that directory and set the permissions for IUSR.

A valid FileCachePath is required for PageSpeed optimization to operate. The cache settings can be overridden for each website that will have PageSpeed optimization enabled in the website specific configuration(s).

Set up Memcached for Windows (Highly recommended)

For improved performance and stability (or in multi-process / multi-server scenarios) we recommend using Memcached for Windows

Enabling PageSpeed optimization

Placing a config file named iispeed.config in the root of a website will enable PageSpeed Optimization in a very basic setup for that site using the core filters, but without highly recommended advanced features like loadfromfile, memcached, IPRO and fetchhttps (unless configured at root level).

Note: this config file needs to be in the root of the website as configured in IIS, not the root of an application. If you have not configured a FileCachePath in the root config, you must do so in this website-specific configuration file.

Configuring PageSpeed Optimization

Next step is tuning the PageSpeed Optimizations. See our configuration documentation.

Tuning IIS

Head over to our IIS tuning post to read more about tuning IIS for PageSpeed optimization.

Optionally: set up PageSpeed's admin interface

For tracking PageSpeed health and benefits as well as cache purging, you can set up PageSpeed's admin interface. As of 2.0.2 the admin interface is set up by default to /pagespeed_admin (only accessible from the local machine).

Disabling IIS WebSpeed on a website

Delete or rename iispeed.config in the root of the website or add the following line to iispeed.config:

pagespeed off

Uninstalling

Run uninstall.cmd with administrative privileges.
Warning: uninstalling IIS WebSpeed will reset the application pools. Current sessions will be lost.

IIS Express installation

The installer does not yet install the filter to IIS Express, it is however possible to add it manually.

  • Stop IIS Express
  • Install IIS WebSpeed (this will add IIS WebSpeed to IIS, but not add it to a site. If IIS is not installed it will not still install the DLLs)
  • Edit the applicationhost.config in the %userprofile%\documents\iisexpress folder. (Just copy and paste the folder part)
  • Add the following line as the last entry to the <GlobalModules> section:
    <add name="We-Amp IISpeed" image="%ProgramFiles%\we-amp\iispeed\release\iispeedmodule.dll" />
  • Add the following line as the last entry to the <modules> section, this can also be done per site by adding this line in the <modules> section of a web.config in the root of an IIS Express website instead:
    <add name="We-Amp IISpeed" />
  • Start IIS Express
  • If you want to uninstall IIS WebSpeed just delete the lines added