Recent Changes - Search:

add Cookbook page







Visitor's book Site map pmwiki-2.2.127

Install On IIS 10

Summary: Install PmWiki on Windows 10 and IIS 10
Version: 2017-03-18
Prerequisites: See below
Status: Living document
Maintainer: skiwi

Questions answered by this recipe


How do I host a PmWiki website on Internet Information Services 10? e.g. for Windows 10.


  • ensure your server has a fixed IP address
  • create server folders for your website data
  • if your website is external
    • ensure your domain name is registered to your external static IP address
    • ensure your router is configured to forward traffic on port 80 to your server machine
Site basic settings
Site basic settings
Site advanced settings
Site advanced settings


These instructions were based on Windows 10 home, therefore Windows Server Manager was not available.

Create folders for your website on the server,

eg \\The-server\home\website\
  • install or copy your PmWiki website to (say)
eg \\The-server\home\website\pmwiki\

Note: physically this is a directory such as D:\home\website\pmwiki\.

Set website's folders specific application pool identity
Set site's specific application pool identity
Website Anonymous Authentication
Set website to use application pool identity
Website folder permissions
Website folders permissions
wiki.d folder permissions
wiki.d folder permissions

IIS configuration from IIS Manager

  • right (context) click in the Connections pane
  • choose the Add Website action
  • IIS uses anonymous authentication for PmWiki website users. From the IIS site entry
    • open Authentication
    • select "Anonymous Authentication" and then "edit ..."
    • select "Application Pool Identity"

You may wish to configure the website

  • set default document (to index.php, index.html, or pmwiki.php)
  • turn compression on (or off)
  • disable (or enable) directory browsing

File Permissions

Ensure the "virtual application pool identity"[1][2] (IIS AppPool\WebsiteAppPoolName) permissions are set for the folder in which your pmwiki.php or index.php resides. The defaults values of "Read & Execute, List Contents, Read" are sufficient.

For the folder wiki.d add to the "virtual application pool identity" (IIS AppPool\WebsiteAppPoolName) permissions "Modify, Write".

If you wish to enable uploads add the "virtual application pool identity" (IIS AppPool\WebsiteAppPoolName) permissions "Modify, Write" to the folder uploads.

Setup a secure service in IIS

You will want a certificate, a self-signed certificate won't cut it these days

  • Lets Encrypt is a free, automated, and open Certificate Authority
    • Certify the Web provides a native client to acquire and install a Let's Encrypt certificate


If you copied your PmWiki site from elsewhere you may have to delete the .flock file in the wiki.d directory.

To increase the file upload size above 30MB ensure that

  • in config.php you have set $UploadExtSize for the extensions required (eg $UploadExtSize['jpeg'] = 12000000; # limit .jpeg files to 12MB)
  • using Server Manager open request filtering, choose edit feature settings, and change the Maximum allowed content length (Bytes).
    • to save file user iisreset /stop from the command line, then save file, then iisreset /start,
    or in IIS, right click the name of the server and select properties, check "Enable Direct Metabase Edit".

Release notes

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

See also



See discussion at InstallOnIIS10-Talk?

Page last modified on 2017 Jun 18 08:05

Edit - History - Recent Changes - WikiHelp - Search - email page as link -> mailto:?Subject=KiwiWiki: Install On IIS 10&Body=From KiwiWiki: Install On IIS 10 (//kiwiwiki [period] nz/pmwiki/pmwiki [period] php/Cookbook/InstallOnIIS10) - Install PmWiki on Windows 10 and IIS 10