View source for Manual:Running MediaWiki on Windows

<languages/>
{{Installation Guides}}
<translate>
<!--T:237-->
This page's contents mainly superseded by <tvar name=1>{{ll|Manual:Running MediaWiki on Windows Subsystem for Linux}}</tvar>.
</translate>

<translate><!--T:1--> This page will give you information about installing <tvar name=mw>{{ll|MediaWiki}}</tvar> on a [[w:Microsoft Windows|Microsoft Windows]] system using standard installation methods.</translate>
<translate><!--T:197--> For Windows-only hosting environments, the [[w:WIMP_(software_bundle)|WIMP]] stack (using IIS) was recommended over Apache, (WAMP stack) as of 1.18, for manual installs.</translate>

<translate>
<!--T:198-->
[[w:Nginx|Nginx]] - an alternative to apache and IIS - may be useful if you support MediaWiki across other host operating systems and/or are already using Nginx for internal hosting.

==Required software== <!--T:11-->

<!--T:249-->
See <tvar name="1">{{ll|Manual:Installation requirements}}</tvar>.

=== Getting required software === <!--T:220-->
</translate>
<translate><!--T:23--> Although these products are not that difficult to configure under Windows, it can be ''extremely'' difficult to install (by difficult, it takes 30 minutes for WIMP) and configure Apache+MySQL+PHP one product at a time if completely new to apache/mysql/php.</translate>
<translate><!--T:238--> Under such circumstances it is highly recommended to look for a LAMP or WAMP pre-made combination which can just be installed and used.</translate>
<translate><!--T:239--> These will save you 99% of the trouble of configuring each package manually.  The down-side is that some of these are trimmed down or modified versions which makes it hard to upgrade individual components, and other ones are seriously out of date.</translate>

<translate>
=== XAMPP === <!--T:221-->

<!--T:204-->
The most popular of which is XAMPP:

<!--T:248-->
* [<tvar name=xampp>https://www.apachefriends.org/index.html</tvar> XAMPP]

=== WebPI === <!--T:230-->
</translate>
<translate><!--T:231--> Microsoft Web Platform Installer can install required pre-requisites for you.</translate>
<translate><!--T:232--> See [<tvar name=url>https://morecomputerstuff.wordpress.com/2016/01/16/mediawiki-on-windows/</tvar> blog].</translate>

<translate>
=== Bitnami === <!--T:222-->

<!--T:206-->
* Bitnami is a free suite of compatible installers for open source software.</translate> <translate><!--T:207--> It supports an Nginx stack <tvar name=nginx>[https://bitnami.com/stack/nginx]</tvar>, Microsoft WAMP <tvar name=wamp>[https://bitnami.com/stack/wamp]</tvar>), a generic LAMP stack <tvar name=lamp>[https://bitnami.com/stack/lamp]</tvar> and XAMPP (which it will not install itself and on which only XAMPP-specific bitnami installers work <tvar name=xampp>[https://bitnami.com/stack/xampp]</tvar>).</translate> <translate><!--T:208--> Bitnami installs MediaWiki on any of those, and they work alongside Wordpress or other software bitnami supports.</translate> <translate><!--T:209--> ''See Bitnami itself for instructions <tvar name=bitnami>[http://bitnami.com]</tvar> and updated support data.''</translate> <translate><!--T:210--> This can be a good option if you intend to use only the long term stable supported MediaWiki releases.</translate> <translate><!--T:211--> Support for older versions is not guaranteed.</translate>

<translate>
=== WAMP === <!--T:223-->

<!--T:224-->
See https://www.wampserver.com/en/

=== WIMP === <!--T:225-->
</translate>
See https://learn.microsoft.com/en-us/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis

<translate>
==Optional Software== <!--T:93-->

===Diffutils=== <!--T:94-->

<!--T:95-->
Diffutils (which contains diff3) can be downloaded from [<tvar name=gnuwin-utils>https://gnuwin32.sourceforge.net/packages/diffutils.htm</tvar> here], and File (file type checker) from [<tvar name=gnuwin-file>https://gnuwin32.sourceforge.net/packages/file.htm</tvar> here].

<!--T:96-->
To activate the use of diffutils within MediaWiki, you have to ignore the fact that they won't be found during installation (they may actually be found if you install diff into your path) and open up LocalSettings.php to make the following changes:
</translate>

<syntaxhighlight lang="diff" style="overflow:auto;">
- $wgDiff3 = "/usr/bin/diff3";
+ $wgDiff3 = "C:/Program Files/GnuWin32/bin/diff3.exe";
</syntaxhighlight>
<syntaxhighlight lang="diff" style="overflow:auto;">
- $wgMimeDetectorCommand = "file.exe -bi"; #use external mime detector (linux)
+ $wgMimeDetectorCommand = "C:/Program Files/GnuWin32/bin/file.exe -bi"; # <translate nowrap><!--T:236--> use external mime detector</translate>
</syntaxhighlight>

<translate>
<!--T:100-->
Please note that you have to replace "C:/Progra..." with the actual location where you installed the tools to.

===ImageMagick=== <!--T:101-->
</translate>

{{note|1=<translate><!--T:102--> PHP now comes with GD enabled by default which will work for thumbnailing.</translate> <translate><!--T:240--> GD will not require any configuration or modification to be used.</translate> <translate><!--T:241--> Therefore it's highly recommended to '''not''' install ImageMagick, since it is known to be unstable.</translate>  <translate><!--T:243--> In MediaWiki, disable ImageMagick in <tvar name=1><code>LocalSettings.php</code></tvar> by setting <tvar name=2><code>$wgUseImageMagick</code></tvar> to <tvar name=3>{{phpi|false}}</tvar>.</translate>}}

<translate><!--T:244--> [<tvar name=1>https://imagemagick.org/script/download.php#windows</tvar> Download ImageMagick on Windows].</translate>
<translate><!--T:245--> To make image thumbnailing work, you will need to open <tvar name=1>includes/Image.php</tvar>, locate the line that starts with <tvar name=2><code>$cmd  =  $wgImageMagickConvertCommand .</code></tvar>, and remove the <tvar name=3>escapeshellarg()</tvar> function, then do the same to the next line, so that the command variable builds like this:</translate>

<syntaxhighlight lang="php" style="overflow:auto;">
 $cmd  =  $wgImageMagickConvertCommand .
       " -quality 85 -background white -geometry {$width} ".
       ($this->imagePath) . " " .
       ($thumbPath);
</syntaxhighlight>

<translate>
<!--T:105-->
In addition, check to be sure that the <tvar name=1><code>$wgImageMagickConvertCommand</code></tvar> in localsettings.php points to:
</translate>

 (<translate><!--T:233--> your imagemagick folder path</translate>)'''/'''convert.exe

{{Note|1=<nowiki/>
* <translate><!--T:234--> use the '''.exe''' extension! It won't work, if omitted.</translate>
* <translate><!--T:235--> use a path '''without spaces''' as install path for ImageMagick or use the short name of the path.</translate>
}}

<translate>
<!--T:106-->
Another way to make this work is to add the ImageMagick path to your Windows PATH variable, and simply setting the <tvar name=1><code>$wgImageMagickConvertCommand</code></tvar> in <tvar name=2>LocalSettings.php</tvar> as follows (note that you must still modify <tvar name=3>Image.php</tvar> as shown above):</translate>

<syntaxhighlight lang="php" style="overflow:auto">
$wgImageMagickConvertCommand = "convert.exe";
</syntaxhighlight>

<translate><!--T:107--> Make sure that the Internet Guest Account (Usually IUSR_MACHINENAME) has Read & Execute rights to the ImageMagick bin directory.</translate>
<translate><!--T:246--> Without this you might see an PHP shell execution error similar to what happens when it can't find the convert.exe file.</translate>

<translate>
===Inkscape=== <!--T:228-->
</translate>
<translate><!--T:229--> [[w:Inkscape|Inkscape]] can be used as an alternative SVG thumbnailing tool. [<tvar name=1>https://inkscape.org/release/</tvar> Download Inkscape on Windows].</translate>
<translate><!--T:247--> Here are some example settings to enable Inkscape as the SVG thumnailer in the <tvar name=1><code>LocalSettings.php</code></tvar> file:</translate>

<syntaxhighlight lang="php" style="overflow:auto;">
# Image Converter
$wgSVGConverter = 'Inkscape';

$wgSVGConverters = array(
	'Inkscape' => '"/Program Files/Inkscape/inkscape.exe" --export-filename $output -w $width $input',
);

# Image converter path
$wgSVGConverterPath = '/Program Files/Inkscape';
</syntaxhighlight>

<translate>
===Mathematics Support=== <!--T:108-->

<!--T:227-->
See [[<tvar name=1>Special:MyLanguage/Texvc#Windows</tvar>|Texvc#Windows]].
</translate>

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