View source for Manual:Installation requirements

<languages />
{{InstallationNav}}
<translate>
<!--T:1-->
In addition to [[<tvar name=download>Special:MyLanguage/Download</tvar>|the MediaWiki software]] itself, you need:

<!--T:2-->
* [[<tvar name=1>#Web server</tvar>|A '''web server''' software]] to serve MediaWiki pages to the web browser.</translate>
<translate>
<!--T:3-->
* [[<tvar name=1>#PHP</tvar>|'''PHP''']] to run MediaWiki.</translate>
<translate>
<!--T:4-->
* [[<tvar name=1>#Database server</tvar>|A '''database server''']] to store MediaWiki pages and data.

<!--T:5-->
In addition, there are various [[<tvar name=1>#Optional dependencies</tvar>|optional dependencies]] which are required if you want to use certain advanced features (see below).

<!--T:6-->
If your website is hosted (i.e. you don't have direct control over it) then contact your server administrator or [[<tvar name=1>Special:MyLanguage/Hosting services</tvar>|hosting company]] to ensure these software packages are installed and available.

<!--T:106-->
To run [[<tvar name=1>Special:MyLanguage/Manual:Maintenance scripts</tvar>|MediaWiki maintenance scripts]], you will need command line access.
</translate>

__TOC__ {{clear}}
<translate>
== One-download installation == <!--T:7-->

<!--T:8-->
If you are using Linux, it's best to install the ''Apache'' web server, ''PHP'', and the ''MariaDB'' database server using your package manager. On [<tvar name=url>https://www.debian.org/</tvar> Debian] and [<tvar name=url2>https://www.ubuntu.com/</tvar> Ubuntu], do the following:
</translate>

<syntaxhighlight lang="bash">sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-xml php-apcu php-curl php-mysql</syntaxhighlight>

; <translate><!--T:72--> Software bundles</translate>
<translate><!--T:85--> On other operating systems, use a [[<tvar name=1>Special:MyLanguage/Software bundles</tvar>|software bundle]] like [[<tvar name=2>Special:MyLanguage/Manual:Installing MediaWiki on XAMPP</tvar>|XAMPP]] from <tvar name=apachefriends>[https://www.apachefriends.org/ https://www.apachefriends.org]</tvar> to install and configure all of the important packages &ndash; Apache web server, PHP, and MariaDB &ndash; with only one download.</translate> 
<translate><!--T:9--> It is available for Linux, Windows, Mac and Solaris.</translate> 
<translate><!--T:10--> As of <tvar name=1>{{ym|2021|1}}</tvar>, the latest version of XAMPP includes <tvar name=2>PHP 8.0</tvar> (MediaWiki requires at least <tvar name=3>{{MW stable php requirement}}</tvar>).</translate>

<translate><!--T:75--> Alternatively, if you run Mac OS, you can use [[w:MAMP|MAMP]], which is the equivalent to XAMPP.</translate>
<translate><!--T:76--> MAMP includes the ability to run the Apache web server and a MySQL database.</translate>
<translate><!--T:77--> It is available for both Windows and Mac, but is generally used on Mac instead of Windows.</translate>

<translate>
== Web server == <!--T:11-->
</translate>
<translate><!--T:12--> In order to serve wiki pages to browsers, MediaWiki requires some web server software.</translate>  
<translate><!--T:13--> Often you will not have a choice of which software to use &ndash; it will be the one provided by your [[<tvar name=1>Special:MyLanguage/Hosting services</tvar>|hosting provider]].</translate>

<translate><!--T:104--> MediaWiki is broadly compatible with all major web servers that can invoke a compatible version of PHP.</translate>
<translate><!--T:14--> Most installations use the [[<tvar name=1>Special:MyLanguage/Apache configuration</tvar>|Apache HTTPD]] web server.</translate>
<translate><!--T:105--> <tvar name=1>[https://nginx.org/ Nginx]</tvar> ([<tvar name=url>https://www.nginx.com/resources/wiki/start/topics/recipes/mediawiki/</tvar> configuration example]) is a good choice as well.</translate>

<translate>
== PHP == <!--T:16-->

<!--T:17-->
[[w:PHP|PHP]] is the programming language in which MediaWiki is written, and is required in order to run the software.

<!--T:19-->
* For the latest stable version of MediaWiki, at least '''[<tvar name=url>https://www.php.net/downloads</tvar> PHP <tvar name=1>{{MW stable php requirement}}</tvar>]''' is required.</translate> <translate><!--T:86--> See the page on <tvar name=1>{{ll|Compatibility}}</tvar> for further information.</translate>
{{MediaWiki PHP 7.4.0 to 7.4.2}}
{{MediaWiki PHP 8}}
<translate>
<!--T:21-->
* The following extensions are {{<tvar name=1>tmpl|0={{Git file|composer.json|text=$1}}</tvar>|required}}:
</translate>
**[https://php.net/calendar calendar] - <translate><!--T:99--> required since MW 1.33</translate>
**[https://php.net/dom dom] - <translate><!--T:113--> required since MW 1.34</translate>
**[https://php.net/fileinfo fileinfo] - <translate><!--T:88--> required since MW 1.30</translate>
**[https://php.net/intl intl] - <translate><!--T:98--> required since MW 1.36</translate>
**[https://php.net/json json] - <translate><!--T:114--> required since MW 1.22</translate>
**[https://php.net/mbstring mbstring] - <translate><!--T:82--> required since MW 1.27, recommended in earlier versions</translate>
**[https://php.net/openssl openssl] - <translate><!--T:119--> required since MW 1.27, see <tvar name=2>{{ll|Manual:$wgSessionInsecureSecrets|$wgSessionInsecureSecrets}}</tvar> if unavailable</translate>
**[https://php.net/xml xml] - <translate><!--T:115--> required since MW 1.27, recommended in earlier versions</translate>
**[https://php.net/xmlreader xmlreader] - <translate><!--T:116--> required since MW 1.36</translate>
<translate>
<!--T:120-->
* The following extensions are {{<tvar name=1>tmpl|0={{Git file|composer.json|text=$1}}</tvar>|recommended}} in addition to the required ones:
</translate><!-- this omits most "suggest" entries from composer.json, which are PHP core extensions and can't be installed separately. -->
**[https://php.net/apcu apcu]
**[https://php.net/curl curl]
<translate>
<!--T:26-->
* MediaWiki only requires PHP extensions that are enabled in PHP by default.</translate> <translate><!--T:121--> If your hosting provider provides a basic LAMP environment without these, you may need to install or enable these manually.</translate>
** <translate><!--T:117--> In Debian/Ubuntu, the following command installs all recommended PHP extensions listed above: <tvar name="1"><pre>sudo apt-get install php php-intl php-mbstring php-xml php-apcu php-curl</pre></tvar></translate>
* <translate><!--T:112--> At hosting providers with a control panel such as cPanel, you can often use "Select PHP Version" (PHP Selector) to enable these extensions. (For example, after seeing "You are missing a required extension to PHP that MediaWiki requires to run. Please install: intl")</translate>
<translate>
<!--T:29-->
* On most Debian/Ubuntu-based distros the <tvar name=1><code>php-mysql</code></tvar> package is required if you want MediaWiki to use MySQL.</translate>
<translate>
<!--T:33-->
* Some features of MediaWiki may require PHP functions that execute external processes, like image thumbnailing, that some cheap hosts usually disable.</translate> <translate><!--T:35--> Please take this into consideration if you plan to install MediaWiki on a [[<tvar name=1>Special:MyLanguage/Hosting services</tvar>|shared host]].</translate>
<translate>
<!--T:36-->
* MediaWiki extensions may require additional PHP features, e.g. <tvar name="2">[[VisualEditor]]</tvar> requires <tvar name=libcurl>[https://php.net/curl libcurl]</tvar> support (<tvar name=1><code>php-curl</code></tvar> on Debian/Ubuntu-based distros).

<!--T:37-->
If you need to compile PHP from source, then see <tvar name=1>{{ll|PHP configuration}}</tvar> for compilation options that affect MediaWiki.

== Database server == <!--T:41-->

<!--T:42-->
MediaWiki stores all the text and data (content pages, user details, system messages, etc.) in a database, which it is capable of sharing with other web-based applications (phpBB, etc.).  You will need ''one'' of the following database servers to run the latest version of MediaWiki:
</translate>

* {{ll|Manual:MariaDB|MariaDB}} [https://mariadb.org/download/ {{MW stable MariaDB requirement}}+] <translate><!--T:91--> or</translate> {{ll|Manual:MySQL|MySQL}} [https://dev.mysql.com/downloads/mysql/ {{MW stable mysql requirement}}+]
* {{ll|Manual:PostgreSQL|PostgreSQL}} [https://www.postgresql.org {{MW stable postgresql requirement}}+]
* {{ll|Manual:SQLite|nsp=0}} {{MW stable sqlite requirement}}+

<translate><!--T:108--> Using MariaDB or MySQL is recommended as Wikimedia uses MariaDB.</translate>
<translate><!--T:109--> Any other database servers are less tested and you may likely run into some bugs.</translate>

{{Dropped Oracle MSSQL}}
{{anchor|Control panel}}
{{Note|1=<translate><!--T:48--> Some users find it helpful to install additional '''control panel''' software such as [<tvar name=url>https://www.phpmyadmin.net</tvar> phpMyAdmin] (MySQL/MariaDB) or [<tvar name=url2>https://github.com/phppgadmin/phppgadmin</tvar> phpPgAdmin] (PostgreSQL) to help administer the database server.</translate> <translate><!--T:118--> Some <tvar name="1">{{ll|hosting services}}</tvar> also provide such software.</translate>}}

<translate>
== Hardware requirements == <!--T:51-->
</translate>
<translate><!--T:52--> The recommended minimum requirements are 256MB of RAM for a single-computer website and 85MB of storage, although this will not suffice for a busy public site or a site with uploading enabled.</translate> 
<translate><!--T:53--> Some users have reported running MediaWiki on computers with as little as 48MB of RAM.</translate>

<translate>
== Optional dependencies == <!--T:56-->

<!--T:58-->
* '''ImageMagick''' or '''GD''' is required for [[<tvar name=1>Special:MyLanguage/Manual:Image_administration#Image_thumbnailing</tvar>|Image thumbnailing]].</translate>
<translate>
<!--T:62-->
* '''Shell access''' is required to run <tvar name=1>{{ll|Manual:maintenance scripts|nsp=0}}</tvar>; [[<tvar name=2>Special:MyLanguage/Manual:Upgrading</tvar>|upgrading MediaWiki]] may be more difficult without it.
</translate>
* <translate><!--T:107--> {{<tvar name=1>ll|Manual:$wgEnableEmail</tvar>|Sending email notifications}} via the server itself requires a [[w:Message transfer agent|message transfer agent (MTA)]].</translate>
<translate>
<!--T:89-->
* '''{{<tvar name=1>ll|Manual:$wgDiff3</tvar>|GNU diff3}}''' can be used to automatically resolve conflicts.</translate>
<translate>
<!--T:100-->
* '''{{<tvar name=1>ll|Manual:Memcached</tvar>|memcached}}''' can be used for object caching.

==See also== <!--T:122-->

<!--T:87-->
* <tvar name=compat>{{ll|Compatibility}}</tvar>, for information about how MediaWiki's installation requirements are likely to change in the future
</translate>
* {{ll|Manual:OS specific help}}

[[Category:Installation{{#translation:}}|{{PAGENAME}}]]