DocuWiki Tutorial and Installation How To

The following tutorial describes how to install DokuWiki with your NEXCESS.NET web hosting account. All of our shared hosting and reseller hosting services support Docuwiki.

DokuWiki is a standards-compliant, usable wiki, allowing users to create rich documentation repositories. It is a powerful collaboration tool for teams, organizations and individuals, and uses a simple structure to ensure that documents remain usable outside of the wiki. DokuWiki is distributed under the GPL ("General Public License") meaning its is free to download and use.

Installing DocuWiki

First, make sure your host supports DokuWiki! While we do, not all hosts will suppport DocuWiki. If you're not a NEXCESS.NET client, then you can check the minimum requirements for DokuWiki the official website.

For the sake of this tutorial we'll assume that you own the domain 'johnsmith.com' and are setting up DokuWiki at http://johnsmith.com/docwiki/

1. Get the software and upload it to your hosting account
   Go to the DokuWiki download page and download the ".tgz" version of the software. Upload the DokuWiki.tar file to the home directory of your site. You should do this using an FTP client. If you need help with FTPing files, you can check out the FTP tutorials on our tutorials page.
2. Extract the DocuWiki files
   Once completed open an SSH session to your website. If you do not have SSH access or are not familiar with SSH please visit our SSH tutorial page. Upon opening a new SSH session you should be automatically directed to your home directory where the DokuWiki tgz file is located. Verify the file exists by typing "ls" without the quotation marks then hit enter. This should reveal the contents of your home directory. Now decide where install DokuWiki. If you want to install it in your home directory, continue on to the next step, otherwise simply move the tgz file to the directory you wish to use for DokuWiki. For the purpose of this tutorial we are going to assume you are installing DokuWiki in a folder named docwiki. Run the following command: tar zxvf dokuwiki-*-*-*.tgz (replace the stars * with the appropriate version information). Now we need to move the DokuWiki files from recently extracted directory to the DokuWiki directory we are going to use. To do so simply type mv dokuwiki-*-*-*/* public_html/docwiki/ at the command line without the quotes (remember to replace the stars * with the appropriate version of docwiki). This command will move the contents of dokuwiki-*-*-*/ and place them in docwiki/.
3. Set permissions for the install script
   The DocuWiki install script needs different permissions on some folders. From the command line type the following commands to chmod the DokuWiki folders: chmod 777 conf/
   chmod 777 data/
   chmod 777 data/pages/
   chmod 777 data/attic/
   chmod 777 data/media/
   chmod 777 data/meta/
   chmod 777 data/cache/
   chmod 777 data/locks/
   chmod 777 data/index/ You can also change the file permissions from your ftp client as well.
4. Run the online install script
   You can now use the online install script for the final part of the installation. Open a new browser window, navigate to http://johnsmith.com/docwiki/install.php, (replacing johnsmith.com with your domain name of course.) You should now see the DokuWiki install script. Input the correct information into the appropriate fields. You can always change this information later on. Once your done, click the "Save" button.
   
   Enter the necessary information for your new DocuWiki installation
   Before you go on you need to change the permissons on the folders to 777. To do this run the following commands chmod 777 conf/
   chmod 777 data/
   chmod 777 data/pages/
   chmod 777 data/attic/
   chmod 777 data/media/
   chmod 777 data/meta/
   chmod 777 data/cache/
   chmod 777 data/locks/
   chmod 777 data/index/

All of our shared and reseller hosting packages are fully managed, so feel free to submit a support ticket if you run into any problems setting up or using docuWiki.

Back to web hosting tutorials page