Installing MediaWiki on Ubuntu 20.04
Traducciones al EspañolEstamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.
MediaWiki is the software behind Wikipedia and many of the wiki websites used by organizations and communities around the world. It provides a versatile, open, and free tool for publishing collaborative content. This guide explains how to deploy MediaWiki on Ubuntu 20.04.
Before You Begin
If you have not already done so, create a Linode account and Compute Instance. See our Getting Started with Linode and Creating a Compute Instance guides.
Follow our Setting Up and Securing a Compute Instance guide to update your system. You may also wish to set the timezone, configure your hostname, create a limited user account, and harden SSH access.
sudo. If you’re not familiar with the
sudocommand, see the Users and Groups guide.
Install Apache 2.4:
sudo apt install apache2
Check the web server’s status, verifying that it started running after installation:
sudo systemctl status apache2 --no-pager
If it is not running, enable and start the Apache service:
sudo systemctl enable apache2 sudo systemctl start apache2
See the guide for How to Install Apache Web Server on Ubuntu 18.04 LTS for more details and configuration options for the Apache web server.
Install PHP, the Apache PHP module, and the additional PHP packages required by MediaWiki:
sudo apt install php libapache2-mod-php php-mbstring php-mysql php-xml
NoteMediaWiki requires PHP 7.3.19–24, 7.4.3, or later; it does not work with PHP 7.4.0–7.4.2. The above command should install version 7.4.3, and you can verify this after installation with the command
Install and Configure MariaDB
MediaWiki supports a variety of database options, including MariaDB, MySQL, and PostgreSQL. MariaDB is preferred in the MediaWiki documentation and has been selected for this guide.
sudo apt install mariadb-server
Secure the MariaDB installation:
This script lets you change the MariaDB root password, remove anonymous user accounts, disable root logins outside of localhost, and remove test databases. It is recommended that you answer yes to each of these options. You can read more about the script in the MariaDB Knowledge Base.
Check the database server’s status, verifying that it started running after installation:
sudo systemctl status mariadb --no-pager
If it is not running, enable and start the MariaDB service:
sudo systemctl enable mariadb sudo systemctl start mariadb
See the guide for How to Install MariaDB on Ubuntu 18.04 LTS for more details and configuration options for the MariaDB installation.
Create a database and a database user for MediaWiki by opening MariaDB as the root user (
sudo mariadb -u root -p) and entering the commands given in the following example. Replace
wikidbwith the desired database name,
wikiuserwith the desired database username, and
passwordwith a password for that user, which should not match the database’s root password:
CREATE DATABASE my_wiki; CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Then exit MariaDB:
Download and Extract the MediaWiki Files
tar.gzcontaining the latest release of the MediaWiki software from the official MediaWiki download page.
Alternatively, you can download MediaWiki from the command line:
tar.gzfile to the Apache web server’s document directory. You can find the document directory as the
DocumentRootvariable in the Apache configuration file for your website. Apache’s default website configuration on Ubuntu is located at
/etc/apache2/sites-enabled/000-default.conf. Typically, the document directory defaults to
/var/www/html, which is assumed in the rest of this guide:
sudo mv mediawiki-1.35.0.tar.gz /var/www/html
Remove any other files and/or folders from the web server’s document directory. Apache typically includes an
index.htmlfile in this folder by default, which you can remove with:
cd /var/www/html sudo rm index.html
Navigate to the document directory, and extract the archived files:
sudo tar xvzf /var/www/html/mediawiki-1.35.0.tar.gz
It is recommended that you rename the resulting folder, as the folder name becomes part of the URL used for navigating to your MediaWiki. For the rest of this guide, the name
wis used for this folder:
sudo mv /var/www/html/mediawiki-1.35.0 /var/www/html/w
NoteExtracting the archive as root makes the root user the files’ owner. If this is not your intention, you need to use the
chowncommand to change the files’ ownership after extraction. For more information, see our guide on Linux Users and Groups.
In a web browser, navigate to
index.phpin the base MediaWiki folder; you can use either the web server domain (replacing
domainin the example below) or your Linode’s public IP address (replacing
192.0.2.1below), as in:
NoteIf you choose to set up the MediaWiki installation using your Linode’s IP but later want to use a domain, you can do so by changing the IP address to the appropriate domain in the
LocalSettings.phpfile described below.
Select the setup link, and proceed through the setup steps. Choose the MariaDB option when prompted for a database server, and enter the database name, username, and user password you created for MediaWiki.
LocalSettings.phpfile when prompted at the end of the setup process, then move it or copy its contents to
/var/www/html/w/LocalSettings.phpon your Linode.
Adjust the file’s permissions:
sudo chmod 664 /var/www/html/w/LocalSettings.php
NoteDepending on how you created the
LocalSettings.phpfile on your Linode, you may need to adjust its ownership using
index.phpagain in a web browser to confirm that MediaWiki has been installed successfully.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This page was originally published on