Requirements and Setup

Required Softwares

• PHP 4.1+, Tiki won't work with older versions of PHP.
• A database, most tiki-compliant is MySQL but you can use postgres with a few problems. oracle, sybase *should* be supported. MSSQL still needs some work. MySQL 4.1+ won't work at the moment neither.
• A webserver that can run PHP. Apache is strongly recommended but other webservers may work as well.

Recommended Minimal Hardware Configuration

• 400 MHz processor
• 128 megabytes of RAM (depending the traffic expected)
• more than 60 megabytes free space on disk (source files take about 35MB and the uploaded images (attachments) go on disk)

Optional Softwares or Libs

Some features can require external additional softwares.

• Image processing library for thumbnail generation, dynamic chart generation and Prevent automatic/robot registration. This can be either :
  • GD library > 1.5 and PHP compiled
  • ImageMagick but only for thumbnail generation see ImageMagick Install
    (You don't need to get those 2 libraries if you use PHP 4.3+ since they are bundled.)
• WikiGraph plugin needs GraphViz installed : see GraphViz Install
• Search : For full-text search MySQL 3.23.23+, for boolean full-text search MySQL4.0.1+.
• Webmail : Will need at least PHP 4.2+
• PDF generation : Needs php-xml package. Consider a PHP error message about utf8_decode() upon exportation an indication you don't have it installed.
• Maps : PHP in CGI mode and Mapserver with a PHP module, obtainable from http://mapserver.gis.umn.edu.

PHP Setup

Use a recent versions. 4.2+ is recommended but it will work with 4.1 too (there was a session bug in 4.1.2 which have been pretty problematic).

• You don't need any specific PHP extension to install Tiki but GD is recommended and will be used if you have it. (GD is bundled by default with PHP 4.3+)
• If you want to use uploads (files, images) make sure uploads are enabled in php.ini.
  : file_uploads = On
• Tiki uses sessions (a common mechanism in PHP4) make sure that the path where PHP stores sessions (php.ini) exists and that PHP can write to that path. (special case in Shared Hosting environment where you may have no access to /tmp, in which case replace it with temp, with no shlash).
  : session.save_handler = files
  : session.save_path = /tmp
• It is highly recommended to increase the maximum memory size for PHP scripts from 8 MB to 16 MB in your php.ini configuration file. Uploaded files are hashed with md5(), so watch this setting too if you upload files of several megabytes. Tiki MAY run in 8 MB environments for most actions. If you get Tiki working with such a limit, this doesn't mean that everything will work. Before reporting a problem, particularly getting blank pages, get 16 MB.
  : memory_limit = 16M
• Another settings recommended to change which may cause timeouts if your wiki is large and prevent you from doing a Backup through the Admin menu.
  : max_execution_time = 60
• With PHP4.1, be sure pcre is enabled (enabled by default with PHP4.2+)
• For character encoding consistency reasons it is recommended to set
  : default_charset = "utf-8"

Apache Setup

• see Rewrite Rules for special url-rewrite configuration.

MySQL Setup

Indicated commands are for example only, in case you use command-line. If you are not very comfortable with MySQL, consider using PhpMyAdmin.

• create an empty database for storing tikiwiki data
  : mysqladmin create tikidb
• it's strongly advised you create a new mysql user for acces to the created database
  : mysql -e "grant all on tikidb.* to tikidbuser@localhost identified by 'tikipass';"
  : mysql -e "flush privileges;"

Other DB setup

• reproduce same operation than for mysql with your other DB.