Installation


Table of Contents

DokuWiki Installation 
What then? 
Tailor Wiki 
Global 
User 

DokuWiki Installation 

http://wiki.splitbrain.org/wiki%3AInstall

To install [[DokuWiki]] follow these steps

. Download the newest release from http://www.splitbrain.org/go/dokuwiki[] ((The newset release is at the bottom))
. extract the Tarball somewhere below your webserver root
    * ''cd /var/www''
    * ''tar -xzvf /path/to/dokuwiki.tgz''
. create an empty changes log file using the FreeBSD or linux [[man>touch]] command or by uploading an empty file
    * ''touch dokuwiki/changes.log''
. change the initial owner of all extracted [[DokuWiki]] files to that of ''root'' using [[man>chown]] or your FTP program
    * ''chown -R root:root dokuwiki''.  In FreeBSD, you should type chown -R root:wheel dokuwiki'
. make data directories writable by the webserver, this example assumes you run the webserver as user ''httpd'' ((Note: You should always give as few permissions as possible. Just make sure the webserver is able to write the files.))
    * ''chown -R httpd:httpd dokuwiki/media dokuwiki/attic dokuwiki/data''
. make some additional files writable by the webserver
    * ''chown httpd:httpd dokuwiki/changes.log''
    * ''chown httpd:httpd dokuwiki/conf/users.auth''
. edit ''dokuwiki/conf/dokuwiki.php'' (see [[config]]) if you want to change anything within it \\ or (better) create dokuwiki/conf/local.php containing those lines from dokuwiki.php, which you want to change. This way your changes are preserved when overwriting the dokuwiki.php with a new release.
. to check if everything is set up correctly use the ''check'' option like this: \\ http://wiki.splitbrain.org/doku.php?do=check[] ((of course change the URL to your own server))

What then? 

Here is what you may want to do when everything is up and working.

  * Check the [[security]] page for hotfixes
  * Choose a license for your content -- edit the ''footer.html'' it includes the [[http://creativecommons.org/licenses/by-nc-sa/2.0/|Creative Commons Attribution-NonCommercial-ShareAlike License]] by default
  * Enable Apache URL rewriting in ''.htaccess'' and set the appropriate config option.
  * Change the ''style.css'' to your own ideas
  * Enter a few words how and where you use [[DokuWiki]] in the [[users|userpage]]
  * [[http://freshmeat.net/subscribe/48181/|subscribe]] to DokuWiki at freshmeat.net to stay informed on updates and get a mail whenever a security problem is encountered

documented on: 2005.02.08