There are no notfications.

This article was last reviewed for Debian 9 (Stretch).

MediaWiki installation and configuration for Nginx using PHP-FPM (Debian, upstream)

MediaWiki installation and configuration for Nginx using PHP-FPM (Debian, upstream)
Author: Stefán Örvar Sigmundsson
Initial publication:
Last updated:
Written in: English (United Kingdom)

MediaWiki is a free and open-source wiki software and the world's most popular as such. This article will demonstrate how to install and configure Mediawiki on Debian or its derivatives such as Ubuntu and Linux Mint. The wiki will be configured for the domain as a virtual server of Nginx using PHP-FPM.


Mediawiki can be downloaded from upstream using GNU Wget:

root@computer:~# wget

The data of the archive file can be extracted using GNU Tar:

root@computer:~# tar --extract --file mediawiki-1.30.0.tar.gz

The archive file can be removed after extraction:

root@computer:~# rm mediawiki-1.30.0.tar.gz

A virtual server root directory is created for MediaWiki:

root@computer:~# mkdir --parents /srv/http/

Mediawiki is moved to its virtual server root directory:

root@computer:~# mv mediawiki-1.30.0/ /srv/http/


A file is created to contain the configuration for the virtual server:

root@computer:~$ touch /etc/nginx/sites-available/

The file contains a virtual server declaration:

	access_log /var/log/nginx/;

	error_log /var/log/nginx/;

	listen 80;

	location ~ [^/]\.php(/|$)
		fastcgi_pass unix:/run/php/php7.0-fpm.socket;

		include /etc/nginx/conf.d/http_fastcgi.conf;

	root /srv/http/;



Configuration enablement

The virtual server is enabled by creating a symbolic link to its configuration file in the sites-enabled directory:

root@computer:~$ ln --symbolic /etc/nginx/sites-available/ /etc/nginx/sites-enabled/

Server reinitiation

Nginx is restarted when the configuration is done:

root@computer:~$ systemctl reload nginx.service

Wiki database setup

The database of the wiki can be set up by following the steps presented after browsing to the root directory of the virtual server. At the end of the setup a file will be downloaded called LocalSettings.php that contains the configuration of the wiki as chosen during the wiki setup. The file must be placed in the virtual server root directory of MediaWiki.

Directory ownership and permissions

The virtual server root directory should be protected:

root@computer:~# chown --recursive root:adm /srv/http/
root@computer:~# chmod --recursive 0775 /srv/http/

See also

External links

This article has additional content here.