DokuWiki with Mac OS X and Apache

Apache and PHP are pre-installed on Mac OS X client, but disabled by default. The following should work for Leopard (10.5.x), Tiger (10.4.x) and Panther (10.3.x) client (if there is no previous version of DokuWiki installed):

1. Enable PHP on Mac OS X
   1. For Mac OS X 10.5 you have to modify httpd.conf (Delete the # at line 114 (#LoadModule php5_module) - we make a backup before!)

      $ sudo cp /private/etc/apache2/httpd.conf /private/etc/apache2/httpd.conf.bak
      $ sudo pico /private/etc/apache2/httpd.conf

2. Start Personal Web Sharing in System Preferences → Sharing
3. Download dokuwiki-yyyy-mm-dd.tgz (assuming to ~/Desktop)
4. From the command line:

   $ cd ~/Desktop && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

You should now be able to run the installer at http://localhost/~your_username/dokuwiki/install.php

For Tiger (10.4.x) and Panther (10.3.x) server:

1. Mac OS Server has Apache and PHP pre-installed; they are enabled through the Server Admin application. Enable “php4_module” under Web → Modules, and start (or restart) and configure the web service.
2. Download dokuwiki-yyyy-mm-dd.tgz (assuming to ~/Desktop)
3. From the command line:

   $ cd ~/Desktop && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

You should now be able to run the installer at http://localhost/dokuwiki/install.php

• The third-party Apache2 package runs as 'nobody', not 'www' – change your chown command accordingly
• FYI, On Leopard I'm seeing my third party Apache2 running as 'daemon' instead of 'nobody'.
• When editing any config files manually, make sure they are saved with UNIX lineendings (LF) not Mac lineending (CR)
• When clicking on links doesn't work -will not bring you to the requested page- nor does the Login-button, you should supply DokuWiki with a basedir. For this add¹⁾ the following line in your local.php²⁾ file (Mind that the absolute dir from your serveroot is not the root from your computer, but the root from your profile with leading tilde (~).) :

$conf['basedir']     = '/~yourusername/dokuwiki/';      //absolute dir from serveroot - blank for autodetection

• In OSX 10.4, ACL doesn't work properly with the build-in webserver. In the DokuWiki, when entering the UN + PW on the Login page, it responds with “Sorry, username or password was wrong.”
• There is a somewhat outdated HOWTO for DokuWiki on Tiger available

What about MacPorts? Can anyone offer guidance there? (the MacPorts documentation is sparse on everything, so some help here would be nice)