Revision [10940]

This is an old revision of WikkaInstallation made by DocXoc on 2005-09-07 02:20:58.


WikkaDocumentation Wikka Documentation

Installing Wikka

Short instructions

See also:
Installing Wikka takes just a few steps:

  1. Unpack the distribution files
  1. Upload them into a directory that can be accessed via the web.
  1. Create the database for wikka
  1. 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).
  1. 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 program like Winzip, 7zip or Winrar for this. Make sure you let it re-create (sub) directories.
  1. Upload the contents of the Wikka directory into your webfolder (something like www or public_html, for example www-data in debian, apache on redhat linux); or a subdirectory of that if you prefer [see *note].
  1. Create the database for wikka. If you can, use phpmyadmin for it, but you could also CreateNewDB from the prompt. If your host won't let you create a new database, don't worry - you can use an existing one and tell the installer to use a prefix for all the table names so there won't be any name clashes.
    You also need to have (or create) a user for the database with sufficient permissions for Wikka to use to access the database; this user needs all the usual permissions for reading, writing, modifying and deleting records, as well as creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
  1. Point your browser to your web directory where Wikka is located - this will start the installer.
  1. Follow the instructions of the installer.

*note: If you are installing in a subdirectory and using mod_rewrite, see ModrewriteInSubdirectoryWorkaround.

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