====== DokuWiki on FreeBSD ====== 
To install [[:DokuWiki]] using the FreeBSD ports tree, do the following:
  #> cd /usr/ports/www/dokuwiki
  #> make install clean
The default DokuWiki directory is ''/usr/local/www/dokuwiki'' -- Of course the directory can be changed or symbolic linked to anywhere :-)

To configure dokuwiki copy the options from the /usr/local/www/dokuwiki/conf/dokuwiki.php file you want to edit to ''/usr/local/www/dokuwiki/conf/local.php''.

This should be done because a portupgrade will overwrite dokuwiki.php.

To upgrade using the ports tree, do:

  #> portupgrade dokuwiki

Make sure that the ports tree has been updated, or this will have no effect.

-- -- -- -- -- 

In addition to building from source, as of freeBSD 10+, one can now use the package manager:

  pkg install dokuwiki

The package maintainer recommends moving the data directory, and as noted above, it can be moved anywhere.  Here is a common set-up and set of commands for moving it outside of the web server's root directory.

  mv /usr/local/www/nginx/dokuwiki/data /usr/local/www/data
  nano /usr/local/www/nginx/dokuwiki/conf/local.php

Inside the local.php file, add something like this:

  $conf['savedir'] = '/usr/local/www/data/';

Close the file and now let's make sure that new directory can be accessed by externally:

  sudo chmod -R 775 /usr/local/www/data
  sudo chown -R www /usr/local/www/data

This should remove the security warning from the Admin/Install pages.