Manual:Installation guide

This guide provides instructions on how to install and configure MediaWiki, both 1>#Manual installation|manually, and by easier 2>#Alternatives to manual installation|alternatives.

1>#Wiki families (multiple wikis)|Installing more than one wiki and 2>#Installing an existing wiki|installing existing wikis are also covered.

The 1>#Appendices|appendices provide links to more detailed installation notes for specific system configurations and other less common uses of the software.

Upgrade guide
If you are already running MediaWiki, see the upgrade>Special:MyLanguage/Manual:Upgrading|Upgrade guide.

Summary
For experienced users, here is the quick version of the installation instructions. Most users (like if you don't know how to install or check for the prerequisite software on your computer) will want to links>#Main-installation-guide|follow the main installation guide.

  Check that your system meets the following minimum requirements. ( See installreq>Special:MyLanguage/Manual:Installation requirements|Installation requirements for more details. Make sure to also check the releasenotes>Special:MyLanguage/Release notes|RELEASE NOTES shipped with MediaWiki for requirements. ) You'll need:


 * download>Special:MyLanguage/Download|MediaWiki (current stable version is )


 * A web server such as Apache or IIS
 * Local or command line access is needed for running maintenance scripts


 * <tvar|php>PHP</> version or later
 * with [<tvar|pcre>https://secure.php.net/pcre</> Perl Compatible Regular Expressions]
 * with [<tvar|spl>https://secure.php.net/spl</> Standard PHP Library]


 * with [<tvar|json>https://secure.php.net/book.json</> JSON support]


 * A database server, that is, one of the following:

thumbnail>Special:MyLanguage/Manual:image thumbnailing</>|Image thumbnailing and <tvar|texvc>TeX</> require additional programs. parsoid>Special:MyLanguage/Parsoid</>|Parsoid (required by visualeditor>Special:MyLanguage/VisualEditor</>|VisualEditor) and other services have their own requirements. </li> <li> download>Special:MyLanguage/Download</>|Download MediaWiki and extract the archive to a web-accessible folder on your computer. </li> <li> Point your browser to the directory where MediaWiki was extracted and follow the link to the setup screen. It should be in the form <tvar|url> </>. Replace directory with the path to your extracted MediaWiki folder. If installing on a local machine, replace domain with. If you install locally and later want to access your wiki from domain, then you will need to change LocalSettings.php from  to domain. If installed on a remote server, replace domain with your server's domain name (eg: <tvar|url>www.myserver.com</>). </li> <li> cfg-script>Special:MyLanguage/Manual:Config script</>|Follow the on-screen instructions to complete the process. </li> </ol>

These instructions are deliberately brief. There is a lot that could go wrong, so if in doubt, you are advised to read the 1>#Main installation guide</>|full instructions!

Main installation guide

 * Before installing MediaWiki, read these:
 * ( Important:  Check these before going any further! )
 * ( Important:  Check these before going any further! )
 * ( Important:  Check these before going any further! )


 * 1>Special:MyLanguage/Manual:Installing MediaWiki</>|Installing MediaWiki


 * Configuring MediaWiki
 * 1>Special:MyLanguage/Manual:Config script</>|Initial configuration (using the configuration script)
 * 2>Special:MyLanguage/Manual:System administration</>|Further configuration
 * 3>Special:MyLanguage/Manual:Extensions</>|Installing extensions

Alternatives to manual installation
If your head is swimming from reading the above &mdash; or you feel frustrated, stuck, or lost &mdash; this section is for you...

You can avoid manual installation by using a pre-integrated MediaWiki appliances>Special:MyLanguage/Software appliances</>|software appliance, host-serv>Special:MyLanguage/Hosting services</>|hosting services with 1-click installation, or wiki farms.

If you are installing for hacker>Special:MyLanguage/How to become a MediaWiki hacker</>|development or testing, consider using vagrant>Special:MyLanguage/MediaWiki-Vagrant</>|MediaWiki-Vagrant, a set of configuration scripts for Vagrant that automate the creation and update of a virtual machine that runs MediaWiki and your choice of extensions and services.

Official docker images are released on [<tvar|1>https://hub.docker.com/_/mediawiki</> Docker Hub].

You can also use community resources based on platforms such as [<tvar|url>https://github.com/rlewkowicz/docker-mediawiki-stack</> Docker].

This is managed by Jenkins and should be kept up-to-date for some time.

These are community based resources and should always be treated with some measure of caution. Use at your own risk.

Wiki families (multiple wikis)

 *  Main page: 

A wiki family is more than one wiki installed on the same computer.

Installing MediaWiki more than once
One approach is to install multiple instances of MediaWiki (such as with a 1>Special:MyLanguage/Software bundles#MediaWiki pre-integrated with AMP packages</>|software bundle like the Bitnami MediaWiki Stack) in different directories – one for each wiki.

For example, you want an enterprise wiki and a personal wiki, and you want to keep them totally separate.

Multiple wikis with one MediaWiki
You could use a single installation of MediaWiki for multiple wikis, by either:


 * 1) Using a different database for each wiki.  See <tvar|1></>. 


 * 1) Using a different database prefix for each wiki.  See <tvar|1></>. 

Installing an existing wiki
Some users wish to install MediaWiki with Wikipedia, Wiktionary, or some other wiki loaded. This is useful for reading offline, for conducting experiments, and for mirroring/forking.

The main (but not necessarily the easiest) method for doing this is to install MediaWiki and then import. '' See 1>Special:MyLanguage/Manual:FAQ#Wiki importing</>|Manual:FAQ#Wiki importing. ''

(Non-MediaWiki solutions, such as Xowa and Kiwix, can be found at w:Wikipedia:Database download, and are probably the best options).

Advanced uses
The following pages give instructions about how to install/configure MediaWiki for other, less common purposes.
 * stick>Special:MyLanguage/Manual:Wiki on a stick</>|Installing MediaWiki on a memory stick

Advanced configuration
The following pages cover some of the more advanced configuration options:
 * 1>Special:MyLanguage/Manual:Configuration</>|Advanced configuration
 * 2>Special:MyLanguage/Manual:Administrators</>|Wiki administration

Installation assistance

 * FAQ: faq>Special:MyLanguage/FAQ#Installation and configuration</>|FAQ#Installation and configuration
 * channel on


 * mailList>mail:mediawiki-l</>|mediawiki-l is the high-traffic mailing list to ask for support.

System-specific instructions
The following pages give more detailed installation instructions aimed at specific systems. However, by and large install-mw>Special:MyLanguage/Manual:Installing MediaWiki</>|Manual:Installing MediaWiki is more up to date, and better written than the per system docs, and as such it is recommended you first consult the install-mw>Special:MyLanguage/Manual:Installing MediaWiki</>|main install instructions before looking at a per system installation documents.


 * Intranet