Revision [5657]

This is an old revision of WikkaInstallation made by NilsLindenberg on 2005-02-05 18:36:19.


Wikka Documentation

Installing Wikka

Short instructions

If you are upgrading from an earlier version of Wikka or from WakkaWiki, see Upgrading Wikka to the latest release.
If you encounter problems during the installation, take a look at WikkaTroubleshooting.
Installing Wikka takes just a few steps:
  1. Unpack the distribution files
  2. Upload them into a directory that can be accessed via the web.
  3. Create the database for wikka
  4. Go to the corresponding URL. A web-based installer will walk you through the rest.

If your website, say,, is mapped to the directory /home/johnny/www/,
and you have uploaded the Wikka distribution files into /home/johnny/www/wikka/, you should go to

Longer version

  1. Download the wikka-file from the HomePage. It is recommended to use the latest version marked as stable, unless you are interested in doing beta-testing (which is a good thing to be done, too)
  2. The file is a *.tar.gz file, which means that it is a packed file which you need to unpack.
- Windows users can use a programm like Winzip, 7zip or Winrar for this
  1. Upload all of the directory into your webfolder (something like www or public_html, for example www-data in debian, apache on redhat linux).
  2. Create the database for wikka. If you can, use phpmyadmin for it, but you could also do it from the prompt
  3. Point your browser to your web directory
  4. Follow the instructions of the installer

Config file
During first installs, the installer will try to create a file called wikka.config.php in your Wikka directory. In order to do this, you will need to either make the Wikka directory writable by the web server, or create a new (empty) file called wikka.config.php which is writable by the web server. On Unix systems this can be done via the following commands:
touch wikka.config.php; chmod 666 wikka.config.php; (don't forget to remove write access again later, i.e. chmod 644 wikka.config.php).
If the installer still fails to create the file, it will dump the file's contents which you can then save and upload manually.

IMPORTANT: for installing or upgrading Wikka, do NOT access any of the files contained in the setup/ subdirectory. They're used by the web-based installer/updater and should not be called directly from a browser.

There are 88 comments on this page. [Show comments]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki