- \n
- Install Nginx on Ubuntu 16.04<\/li>\n
- Install and Configure PHP-FPM<\/li>\n
- Install and Configure MySQL Database<\/li>\n
- Download and Configure MediaWiki<\/li>\n
- Generate new SSL Letsencrypt on Ubuntu 16.04<\/li>\n
- Configure Nginx Virtual Host for MediaWiki Installation<\/li>\n
- MediaWiki Web-Based Installation<\/li>\n
- Configure Default Skin MediaWiki<\/li>\n<\/ol>\n
Prerequisites<\/strong><\/p>\n
- \n
- Ubuntu 16.04 server<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
Step 1 – Install Nginx on Ubuntu 16.04<\/h2>\n
The first step we must do for the MediaWiki installation is to install the web server. So in this section, we will install the Nginx web server, start the Nginx service, and then enable it to launch automatically at system boot.<\/p>\n
Before installing the Web server, connect to your server, update all repositories, and then upgrade.<\/p>\n
sudo apt update
sudo apt upgrade -y<\/p>\nNow install Nginx using the following apt command.<\/p>\n
sudo apt install nginx -y<\/p>\n
After that, start nginx and enable it to launch at system boot.<\/p>\n
systemctl start nginx
systemctl enable nginx<\/p>\nNow check the HTTP port using netstat and make sure you see port 80 being used by Nginx.<\/p>\n
netstat -plntu<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04.png\" "\\"\\"")
<\/a><\/p>\nThe Nginx web server has been installed on Ubuntu 16.04.<\/p>\n
Step 2 – Install and Configure PHP-FPM<\/h2>\n
Now we will install the PHP-FPM on Ubuntu 16.04. And we will be using PHP 7.0 for MediaWiki installation.<\/p>\n
Install PHP and PHP-FPM (along with all required extensions) using the apt command below.<\/p>\n
sudo apt install imagemagick php7.0-fpm php7.0-intl php7.0-xml php7.0-curl php7.0-gd php7.0-mbstring php7.0-mysql php-apcu<\/p>\n
And after the installation is complete, we need to change some default configuration for PHP-FPM. We need to increase the upload max file size as well as the memory limit configurations.<\/p>\n
Go to the PHP configuration directory and edit the php-fpm ‘php.ini’ file using vim<\/a>.<\/p>\n
cd \/etc\/php\/7.0
vim fpm\/php.ini<\/p>\nIncrease the ‘upload_max_filesize’ configuration to ’20M’, and increase the ‘memory_limit’ to ‘128M’.<\/p>\n
upload_max_filesize = 20M
Save and exit.<\/p>\n
Now restart the PHP-FPM service and enable it to automatically launch at boot time using the following systemctl commands.<\/p>\n
systemctl restart php7.0-fpm
systemctl enable php7.0-fpm<\/p>\nPHP-FPM now is running on Ubuntu 16.04, and it’s running under the sock file. Check it using the netstat command below.<\/p>\n
netstat -pl | grep php<\/p>\n
And you will get the PHP-FPM sock file as shown below.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-1.png\" "\\"\\"")
<\/a><\/p>\nStep 3 – Install and Configure MySQL Database<\/h2>\n
MediaWiki stores all data and content in the database, and it’s compatible with a variety of database servers. For this guide, we will be using the MySQL database for MediaWiki installation.<\/p>\n
In this step, we will install the MySQL database server and then create a new database and user for MediaWiki.<\/p>\n
Install MySQL database on Ubuntu 16.04 using the following apt command.<\/p>\n
sudo apt install mysql-server mysql-client -y<\/p>\n
You will be asked for the MySQL ‘root’ password – type your own password and press ‘Enter’.<\/p>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-2.png\" "\\"\\"")
<\/a><\/p>\nRepeat your MySQL ‘root’ password.<\/p>\n
![\"Retype](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-3.png\" "\\"\\"")
<\/a><\/p>\nMySQL installation is complete. Now start MySQL and enable it to launch at boot time using the systemctl commands below.<\/p>\n
systemctl start mysql
systemctl enable mysql<\/p>\nNext, we will create a new database and user for MediaWiki. We will create a new database named ‘mediawikidb<\/strong>‘ with the user ‘mediawiki<\/strong>‘ and password ‘mypassword<\/strong>‘.<\/p>\n
Connect to the mysql server using the mysql command below.<\/p>\n
mysql -u root -p<\/p>\n
Now create the database and user with the following MySQL queries.<\/p>\n
create database mediawikidb;
grant all privileges on mediawikidb.* to [email\u00a0protected]<\/a>‘localhost’ identified by ‘mypassword’;
flush privileges;
exit;<\/p>\nMySQL server installed on Ubuntu 16.04, and the database for MediaWiki installation has been created.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-4.png\" "\\"\\"")
<\/a><\/p>\nFor this guide, we will be using the latest MediaWiki version 1.30. And before we download MediaWiki, we need to install some packages on the server.<\/p>\n
Run the apt command below to install new packages.<\/p>\n
sudo apt install composer git zip unzip -y<\/p>\n
Now create new ‘mediawiki’ directory and clone mediawiki source code to that directory.<\/p>\n
mkdir -p \/var\/www\/mediawiki
git clone https:\/\/gerrit.wikimedia.org\/r\/p\/mediawiki\/core.git \/var\/www\/mediawiki<\/p>\n![\"Download](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-5.png\" "\\"\\"")
<\/a><\/p>\nNext, go to the ‘\/var\/www\/mediawiki’ directory and install some PHP dependencies needed for the MediaWiki installation using the composer command.<\/p>\n
cd \/var\/www\/mediawiki
composer install –no-dev<\/p>\n![\"Run](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-6.png\" "\\"\\"")
<\/a><\/p>\nAfter all PHP dependencies installation is complete, change the owner of the mediawiki directory to ‘www-data’ user and group.<\/p>\n
chown -R www-data:www-data \/var\/www\/mediawiki<\/p>\n
The latest version of MediaWiki 1.30 is downloaded in the ‘\/var\/www\/mediawiki’ directory.<\/p>\n
Step 5 – Generate SSL Letsencrypt on Ubuntu 16.04<\/h2>\n
For security reasons, we will run MediaWiki under the HTTPS connection. All HTTP connections will be automatically redirect to HTTPS. And for this purpose, we need SSL certificates. We will be using free SSL from Letsencrypt.<\/p>\n
In order to generate new SSL certificates from Letsencrypt, we need to install letsencrypt command line on to the server. Use the following command to do this:<\/p>\n
sudo apt install letsencrypt -y<\/p>\n
After the installation is complete, stop the Nginx web server.<\/p>\n
systemctl stop nginx<\/p>\n
Next, generate new SSL certificates using the letsencrypt command below.<\/p>\n
letsencrypt certonly<\/p>\n
You will be asked for your email address – it’s used for certificate renew notification.<\/p>\n
So, type your email address and choose ‘OK’.<\/p>\n
![\"Generate](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-7.png\" "\\"\\"")
<\/a><\/p>\nFor the Letsencrypt TOS (Terms Of Service), choose ‘Agree’ and press Enter.<\/p>\n
![\"Lets](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-8.png\" "\\"\\"")
<\/a><\/p>\nAnd now type your wiki domain name, mine is ‘wiki.hakase-labs.co’.<\/p>\n
![\"Enter](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-9.png\" "\\"\\"")
<\/a><\/p>\nAnd when it’s all done, you will get the result as shown below.<\/p>\n
![\"SSL](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-10.png\" "\\"\\"")
<\/a><\/p>\nSSL certificates for MediaWiki installation has been generated in the ‘\/etc\/letsencrypt\/live’ directory.<\/p>\n
The LEMP stack (Linux, Nginx, MySQL, and PHP-FPM) for MediaWiki installation has been set up, and the MediaWiki source code has been downloaded in the ‘\/var\/www\/mediawiki’ directory.<\/p>\n
In this step, we will create a new Nginx virtual host file ‘mediawiki’, and then activate the virtual host.<\/p>\n
Go the Nginx configuration directory and create a new virtual host file ‘mediawiki’ using vim.<\/p>\n
cd \/etc\/nginx\/
vim sites-available\/mediawiki<\/p>\nPaste the following Nginx virtual host for MediaWiki configuration there.<\/p>\n
# HTTP Request will be Redirected to the HTTPS
# HTTPS Configuration
\u00a0\u00a0\u00a0 listen 443 ssl;
\u00a0\u00a0\u00a0 index index.php;
\u00a0\u00a0\u00a0 # SSL Certificate Configuration
\u00a0\u00a0\u00a0 client_max_body_size 5m;
\u00a0\u00a0\u00a0 location \/ {
\u00a0\u00a0\u00a0 location @rewrite {
\u00a0\u00a0\u00a0 location ^~ \/maintenance\/ {
\u00a0\u00a0\u00a0 # PHP Configuration
\u00a0\u00a0\u00a0 location ~* \\.(js|css|png|jpg|jpeg|gif|ico)$ {
\u00a0\u00a0\u00a0 location = \/_.gif {
\u00a0\u00a0\u00a0 location ^~ ^\/(cache|includes|maintenance|languages|serialized|tests|images\/deleted)\/ {
\u00a0\u00a0\u00a0 location ^~ ^\/(bin|docs|extensions|includes|maintenance|mw-config|resources|serialized|tests)\/ {
\u00a0\u00a0\u00a0 # Security for 'image' directory
\u00a0\u00a0\u00a0 # Security for 'image' directory
}<\/p><\/pre>\n
Change as per your requirement\/case, and then save and exit.<\/p>\n
Next, activate a new mediawiki virtual host using the following command.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/mediawiki \/etc\/nginx\/sites-enabled\/<\/p>\n
Test nginx configuration and make sure there is no error. Then restart the service.<\/p>\n
nginx -t
systemctl restart nginx<\/p>\nA new HTTPS port 443 is opened on your server – check it using the netstat command in the following way.<\/p>\n
netstat -plntu<\/p>\n
Shown below is the result.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-11.png\" "\\"\\"")
<\/a><\/p>\nNow open your web browser and type your domain name into the address bar.<\/p>\n
http:\/\/wiki.hakase-labs.co<\/a><\/p>\n
And you will be redirected to the HTTPS connection.<\/p>\n
![\"MediaWiki](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-12.png\" "\\"\\"")
<\/a><\/p>\nClick the ‘set up the wiki’ link on the page to configure MediaWiki.<\/p>\n
– Language Configuration<\/strong><\/p>\n
Choose your own language, we will choose ‘English’ and click ‘Continue’.<\/p>\n
![\"Language](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-13.png\" "\\"\\"")
<\/a><\/p>\n– Environment Checking<\/strong><\/p>\n
And now, MediaWiki will perform environment checking. Make sure you get the result as shown below.<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-14.png\" "\\"\\"")
<\/a><\/p>\nClick ‘Continue’ for installation.<\/p>\n
– Database Configuration<\/strong><\/p>\n
Now for the Database configuration. In the ‘Database name’ field, type ‘mediawikidb’ with prefix ‘wiki_’. Next, type the database user ‘mediawiki’ and password ‘mypassword’.<\/p>\n
![\"Database](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-15.png\" "\\"\\"")
<\/a><\/p>\nAnd click ‘Continue’.<\/p>\n
– Database Settings<\/strong><\/p>\n
As for the Database settings, just leave it default and click ‘Continue’.<\/p>\n
![\"Database](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-16.png\" "\\"\\"")
<\/a><\/p>\n– Create an Admin User<\/strong><\/p>\n
Now we need to create the administrator account. Type your own user, password, and email as shown below.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-17.png\" "\\"\\"")
<\/a><\/p>\nAnd click ‘Continue’.<\/p>\n
– MediaWiki Additional Configuration<\/strong><\/p>\n
And you should get to the page about ‘MediaWiki Additional Configuration’.<\/p>\n
![\"Additional](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-18.png\" "\\"\\"")
<\/a><\/p>\nLeave it with default values, and click ‘Continue’.<\/p>\n
– MediaWiki Installation<\/strong><\/p>\n
Now click ‘Continue’ again to install MediaWiki.<\/p>\n
![\"MediaWiki](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-19.png\" "\\"\\"")
<\/a><\/p>\nAnd you will get to the page similar to the one shown below.<\/p>\n
![\"Installation](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-20.png\" "\\"\\"")
<\/a><\/p>\nClick ‘Continue’ again.<\/p>\n
Now you will see the page says installation is complete. You will be prompted for downloading new file ‘LocalSettings.php’ – download the file.<\/p>\n
![\"Locale](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-21.png\" "\\"\\"")
<\/a><\/p>\nAnd upload the ‘LocalSetting.php’ file to the server mediawiki directory ‘\/var\/www\/mediawiki’. Also, do not forget to change the owner of the file to ‘www-data’ user and group.<\/p>\n
scp LocalSettings.php [email\u00a0protected]<\/a>:\/var\/www\/mediawiki\/
chown -R www-data:www-data \/var\/www\/mediawiki<\/p>\nNow, come back to your web browser MediaWiki installation page, and click the link ‘enter your wiki’. You will be told that MediaWiki has been installed with Nginx web server on Ubuntu 16.04 server.<\/p>\n
![\"MediaWiki](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-install-mediawiki-with-nginx-on-ubuntu-16-04-22.png\" "\\"\\"")
<\/a><\/p>\nStep 8 – Download and Configure Default Skin<\/h2>\n
At this stage, mediawiki installation has been completed. And in this step, we will configure the default skin\/theme.<\/p>\n
Go to the ‘\/var\/www\/mediawiki\/skins’ directory and clone the default skin ‘Vector’.<\/p>\n
cd \/var\/www\/mediawiki\/skins\/
sudo git clone https:\/\/gerrit.wikimedia.org\/r\/mediawiki\/skins\/Vector<\/p>\n
![\"Check](\"https:\/\/www.howtoforge.com\/images\/how_to_install_and_configure_mediawiki_with_nginx_on_ubuntu_1604\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n