Manual:Running MediaWiki on GNU/Linux

<-MediaWiki User's Guide: Running MediaWiki

Required software
www.php.net/manual/en/install.unix.php] )
 * Web server with PHP 4.1.2 or higher (4.3.x is preferred, see [http://www.php.net/manual/en/install.unix.php
 * apache web server
 * PHP
 * A MySQL server. 4.0.x is preferred, but 3.2.x should work as well. (see dev.mysql.com/doc/mysql/en/Installing.html )

These instructions assume you are using Linux and Apache, and that LAMP http://en.wikipedia.org/wiki/LAMP (Linux, Apache, MySQL, PHP) is already set up on your machine.

Configuration

 * 1) Download MediaWiki:  or see MediaWiki from CVS
 * 2) If you downloaded a gzipped file, unzip the source files in some directory: tar zxvf mediawiki-x.y.z.tar.gz
 * 3) The new web-based install does not require root access.  If for some reason you are using the old installation you might need to use commands such as: su - and mv /path_to_mediawiki_unzip_dir/. At this point you should also read the README, RELEASE-NOTES, INSTALL inside the mediawiki-x.y.z directory. However, keep in mind that either those files or this guide may be outdated, in which case someone else would appreciate your updates to this page after you're done :)
 * 4) Move the directory into your web directory: e.g. mv mediawiki-x.y.z /usr/local/apache/htdocs/wiki or mv mediawiki-x.y.z public_html/wiki.
 * 5) To run the install script, you'll need to temporarily make the 'config' subdirectory writable by the web server. The simplest way to do this on a Unix/Linux system is to make it world-writable: chmod -R a+w config
 * 6) At this point you should have Apache and MySQL running (this varies between distributions and setups, see their documentations for specifics). Hop into your browser and surf into the wiki directory. It'll direct you into the config script (if it doesn't, just load up the mediawiki-1.3.0beta4/config/index.php file). Fill out the form...remember you're probably not on an encrypted connection. Gaaah! :)
 * 7) If all goes well, you should soon be told that it's set up your wiki database and written a configuration file. There should now be a 'LocalSettings.php' in the config directory; move it back up to the main wiki directory, and the wiki should now be working.
 * 8) Once the wiki is set up, you should remove the config directory, or at least make it not world-writable (though it will refuse to config again if the wiki is set up) using again chmod -R a-w config.


 * 1) Apache config
 * 2) PHP config
 * 3) MySQL config


 * 1) Documentation:Configuration
 * 2) Help:Configuration
 * 3) Robots.txt -- how to avoid search engines to index the internals of your wiki
 * 4) Rewrite Rules -- how to get rid of /index.php in URLs

Running a PHP Accelerator?
In some cases, when running 1.2.4, one may encounter problems during the install. If this happens, try disabling phpa by placing php_value phpa Off</tt> in .htaccess in the root directory of your install.

Debian GNU/Linux

 * Running MediaWiki on Debian GNU/Linux

Gentoo Linux

 * Running MediaWiki on Gentoo Linux

Mandrake Linux

 * Running MediaWiki on Mandrake

Red Hat Linux

 * Running MediaWiki on Red Hat Linux

Slackware Linux

 * Running MediaWiki on Slackware Linux