====== DokuWiki with Mac OS X and Apache ======



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

  - [[http://the.taoofmac.com/space/HOWTO/Enable%20PHP%20on%20Mac%20OS%20X|Enable PHP on Mac OS X]]
    - 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!)<code bash>
$ sudo cp /private/etc/apache2/httpd.conf /private/etc/apache2/httpd.conf.bak
$ sudo pico /private/etc/apache2/httpd.conf
</code>
  - Start Personal Web Sharing in System Preferences -> Sharing 
  - [[sb>dokuwiki|Download dokuwiki-yyyy-mm-dd.tgz]] (assuming to ~/Desktop)
  - From the command line:<code bash>
$ 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</code>

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

===== Mac OS X Server =====
For Tiger (10.4.x) and Panther (10.3.x) server:

  - 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.
  - [[sb>dokuwiki|Download dokuwiki-yyyy-mm-dd.tgz]] (assuming to ~/Desktop)
  - From the command line:<code bash>
$ 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</code>


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

===== Notes =====
  * 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 and will not bring you to the requested page and logging doesn't either, you should supply dokuwiki with a basedir. For this add((or change this line directly in the dokuwiki.php file)) the following line in your local.php((in the conf direcotry)) file:\\ **$conf['basedir']     = '/~yourusername/dokuwiki/';      //absolute dir from serveroot - blank for autodetection**\\ Mind that the absolute dir from your serveroot is not the root from your computer, but the root from your profile with leading tilde (~).
  * There is a somewhat outdated [[http://the.taoofmac.com/space/HOWTO/Install%20DokuWiki%20on%20Tiger|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)