DokuWiki with IIS

This is for people who want to use DokuWiki on a Windows machine with IIS webserver (Windows 2000, Windows XP or Windows Server 2003, 2008)

• New DL-Link for PHP under IIS (auto-install): IIS-Aid
• If you want to do an offline install and want to use fast-cgi, install the addin before you install php: IIS-FastCGI

(Just install and leave the setting 'download and install FastCGI' and it will auto-detect fast-cgi on your System)

• Use the windows install from PHP's website. See the PHP site for installers or complete packages. PHP can run either as CGI-application or as an ISAPI extension. As an alternative, see the Microsoft IIS Site for automatic setup of PHP.
• If you're using the Windows Cache Extension for PHP, you will need to disable the file caching functionality of the extension by setting wincache.fcenabled to 0 in php.ini.

1. Extract the DokuWiki archive
2. Rename the dokuwiki-YYYY-MM-DD directory to dokuwiki (or whatever else you like) and move it to:
   • BEST Practice is to put it somewhere other than your “system” drive, “D:\dokuwiki”. This is for security and mitigating the chance of a “disk full” condition on this drive.
   • Somewhere below your new webserver documentroot, e.g. c:\inetpub\wwwroot\dokuwiki
   • Secure all the directories as explained at the step 2 of the main Install page.
3. Configure IIS (do one of these):
   • Virtual-Directory in an existing website like “www.YourSite.com/wiki”: so make sure to setup a Virtual Directory mapping to the wiki-code-location
   • New Website like “wiki.YourSite.com”: so add an new website-Config in the IIS and set the Root-Directory to the wiki-code-location
4. Browse to the dokuwiki/ directory and Check the properties of the data/ folder. Ensure that the Internet Guest Account (IUSR_computername) or the appropriate web server account (or web server group like IIS_WPG) has Folder level “Write” permissions to the data/ folder.
5. The wiki installer should now be available at http://localhost/dokuwiki/install.php

NOTES

• If you want to write the /conf/local.php (and you have to do that during the install-process!) ensure, that the Internet Guest Account (IUSR_computername) or the appropriate web server group (like IIS_WPG) has “Write” permissions to the conf/local.php file.
• If you want to start your new DokuWiki, ensure, that the Internet Guest Account (IUSR_computername) or the appropriate web server group (like IIS_WPG) has “Write” permissions to the conf/local.php file.

• Use the windows install from PHP's website. See the PHP site for installers or complete packages. There are 2 installers, choose the “thread safe” and the “non-thread safe” installer. It is recommended that you use a non-thread safe build of PHP with IIS 7 FastCGI. A non-thread safe build of PHP provides significant performance gains over the standard build by not doing any thread-safety checks, which are not necessary, since FastCGI ensures a single threaded execution environment.
• PHP can run either as CGI-application or as an ISAPI extension. These instructions are for Fast-CGI as it is quicker and more stable than ISAPI. Even Microsoft instructs to install using Fast-CGI, even though they invented ISAPI. See the How To

1. Extract the DokuWiki archive
2. Rename the dokuwiki-YYYY-MM-DD directory to dokuwiki (or whatever else you like) and move it to:
   • BEST practice is to put it somewhere other than your system drive(e.g. D:\dokuwiki). This is for security and to mitigate the chance of a disk full condition on this drive.
   • However you can also put it somewhere below your new webserver documentroot, (e.g. c:\inetpub\wwwroot\dokuwiki)
3. Secure all the directories as explained at the step 2 of the main Install page.
   • You will have to give the IUSR account read & execute permissions to the website, as it is not there by default.
     • In IIS Manager left click the site name
     • Click “Edit Permissions” in the Actions pane OR right click and choose “Edit Permissions” from the shortcut menu.
     • Click the Security tab
     • Click the Edit button
     • Click the Add button
     • Click the Locations button and choose the local server name
     • Now type in IUSR and click OK, and OK again.
4. Configure IIS (do one of these):
   • Virtual-Directory in an existing website like “www.YourSite.com/wiki”: so make sure to setup a Virtual Directory mapping to the wiki-code-location
   • New Website like “wiki.YourSite.com”: so add an new website-Config in the IIS and set the Root-Directory to the wiki-code-location
5. Browse to the dokuwiki/ directory and Check the properties of the data/ folder. Ensure that the Internet Guest Account(IUSR), the appropriate web server account or Server Group(IIS_IUSRS) has Folder level “Write” permissions to the data/ folder. See above for instructions.
6. Browse to the dokuwiki/ directory and Check the properties of the conf/ folder. Ensure that the Internet Guest Account(IUSR), the appropriate web server account or Server Group(IIS_IUSRS) has Folder level “Write” permissions to the conf/ folder. See above for instructions.
7. The wiki installer should now be available. Depending on how you installed it you can find it at http://localhost/dokuwiki/install.php OR http://(wiki site name)/install.php
8. Browse to the dokuwiki/ directory and delete the install.php file.