Update migrateUserGroup to deal with primary key issue
[mediawiki.git] / INSTALL
blobc4bb8be987f486a0b14bc272125ed4a449131311
1 ---
2 Installing MediaWiki
3 ---
5 Starting with MediaWiki 1.2.0, it's possible to install and configure the wiki
6 "in-place", as long as you have the necessary prerequisites available.
8 Required software:
9 * Web server with PHP 5.3.2 or higher.
10 * A SQL server, the following types are supported
11 ** MySQL 5.0.2 or higher
12 ** PostgreSQL 8.3 or higher
13 ** SQLite 3.3.7 or higher
14 ** Oracle 9.0.1 or higher
16 MediaWiki is developed and tested mainly on Unix/Linux platforms, but should
17 work on Windows as well.
19 If your PHP is configured as a CGI plug-in rather than an Apache module you may
20 experience problems, as this configuration is not well tested. safe_mode is also
21 not tested and unlikely to work. 
23 If you want math support see the instructions in math/README
25 Don't forget to check the RELEASE-NOTES file...
28 Additional documentation is available online, which may include more detailed
29 notes on particular operating systems and workarounds for difficult hosting
30 environments:
32 http://www.mediawiki.org/wiki/Manual:Installation_guide
35 ******************* WARNING *******************
37 REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE 
38 ATTEMPTING TO INSTALL OR UPGRADE!!!
40 ******************* WARNING *******************
42 ----
43 In-place web install
44 ----
46 Decompress the MediaWiki installation archive either on your server, or on your
47 local machine and upload the directory tree. Rename it from "mediawiki-1.x.x" to
48 something nice, like "wiki", since it'll be in your URL.
50   +--------------------------------------------------------------------------+
51   |  Hint: If you plan to use a fancy URL-rewriting scheme to prettify your  |
52   |  URLs, you should put the files in a *different* directory from the      |
53   |  virtual path where page names will appear.                              |
54   |                                                                          |
55   |    See: http://www.mediawiki.org/wiki/Manual:Short_URL                   |
56   +--------------------------------------------------------------------------+
58 Hop into your browser and surf into the wiki directory. It'll direct you into
59 the config script. Fill out the form... remember you're probably not on an
60 encrypted connection.
61 Gaaah! :)
63 If all goes well, you should soon be told that it's set up your wiki database
64 and generated a configuration file. There is now a copy of "LocalSettings.php"
65 available to download from the installer. Download this now, there is not a
66 way (yet) to get it after you exit the installer. Place it in the main wiki
67 directory, and the wiki should now be working.
69 Once the wiki is set up, you should remove the mw-config directory (though it will
70 refuse to config again if the wiki is set up).
72 ----
74 Don't forget that this is free software under development! Chances are good
75 there's a crucial step that hasn't made it into the documentation. You should
76 probably sign up for the MediaWiki developers' mailing list; you can ask for
77 help (please provide enough information to work with, and preferably be aware of
78 what you're doing!) and keep track of major changes to the software, including
79 performance improvements and security patches.
81 http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce (low traffic)
83 http://lists.wikimedia.org/mailman/listinfo/mediawiki-l (site admin support)
85 http://lists.wikimedia.org/mailman/listinfo/wikitech-l (development)