Cómo instalar MediaWiki en Ubuntu 24.04

MediaWiki es un software wiki de código abierto escrito en PHP y MySQL. Es escalable y extensible, impulsando sitios como Wikipedia y Wikimedia. MediaWiki se puede utilizar como una plataforma de colaboración y documentación. Te permite organizar la documentación y hacerla pública para todos. Soporta múltiples idiomas y ofrece personalización para diferentes aspectos, desde temas/skins, plugins y editores.

Esta guía te mostrará cómo instalar el software MediaWiki en un servidor Ubuntu 24.04. Instalarás MediaWiki con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP), y luego lo asegurarás con HTTPS a través de Certbot y Letsencrypt.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor.

Instalando Dependencias

Para instalar MediaWiki, debes asegurarte de que las dependencias estén instaladas en tu sistema. Actualmente, la versión estable de MediaWiki 1.41 requiere PHP 8.1-83. En esta sección, instalarás Apache, el servidor MariaDB, PHP 8.3 y ImageMagick como dependencias para MediaWiki.

Primero, ejecuta el siguiente comando para actualizar tu repositorio de Ubuntu.

sudo apt update

Ahora, instala las dependencias para MediaWiki usando el siguiente comando. Ingresa Y para confirmar el proceso. Con esto, instalarás el LAMP Stack (Apache, MySQL/MariaDB y PHP) y los paquetes de ImageMagick.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

Después de que la instalación haya terminado, verifica el estado del servicio apache2 con el siguiente comando. Verás que el servidor web Apache está en ejecución y habilitado.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Verifica el servicio mariadb con el siguiente comando. Puedes ver a continuación que el servidor MariaDB está en ejecución y habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por último, verifica la versión de PHP usando el siguiente comando. Verás PHP 8.3 instalado en tu sistema.

sudo php -v

Configurando UFW

Agrega y habilita el perfil Apache Full en UFW con lo siguiente:

sudo ufw allow "Apache Full"

Ahora verifica las reglas habilitadas en UFW con el comando ufw status a continuación. El perfil Apache Full abre puertos para los protocolos HTTP y HTTPS.

sudo ufw status

Configurando PHP

Después de haber instalado las dependencias, configurarás PHP editando el archivo de configuración predeterminado /etc/php/8.3/apache2/php.ini.

Ejecuta el siguiente comando nano para abrir el archivo de configuración de PHP /etc/php/8.3/apache2/php.ini.

sudo nano /etc/php/8.3/apache2/php.ini

Descomenta y cambia la configuración predeterminada de PHP con lo siguiente. Asegúrate de ajustar tanto las opciones memory_limit como date.timezone según sea necesario.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

Guarda y cierra el archivo cuando termines.

Ahora ejecuta el comando a continuación para reiniciar el servidor web Apache y aplicar tu configuración de PHP.

sudo systemctl restart apache2

Configurando el servidor MariaDB

Ahora que PHP está configurado, asegurarás el servidor MariaDB y crearás una nueva base de datos y usuario para MediaWiki. Asegurarás MariaDB con la utilidad mariadb-secure-installation, luego crearás una nueva base de datos y usuario a través del cliente mariadb.

Asegura tu instalación del servidor MariaDB con el siguiente comando mariadb-secure-installation.

sudo mariadb-secure-installation

Ahora se te preguntará sobre las siguientes configuraciones del servidor MariaDB:

• La instalación predeterminada de MariaDB viene sin contraseña, presiona ENTER cuando se te pida la contraseña.
• Ahora ingresa Y para configurar la contraseña de root de MariaDB. Luego, escribe la nueva contraseña para MariaDB y repite la contraseña.
• Ingresa Y para eliminar el usuario anónimo de tu instalación de MariaDB.
• Ingresa Y nuevamente cuando se te pida deshabilitar el inicio de sesión remoto para el usuario root de MariaDB.
• Ingresa Y para eliminar la base de datos de prueba predeterminada de tu MariaDB.
• Por último, ingresa Y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

Después de asegurar MariaDB, inicia sesión en el servidor MariaDB con lo siguiente - Ingresa tu contraseña de root cuando se te pida.

sudo mariadb -u root -p

A continuación, ejecuta las siguientes consultas para crear una nueva base de datos y usuario para MediaWiki. En este ejemplo, crearás una nueva base de datos mediawikidb, un usuario mediawiki con la contraseña mediawikipassdb. Puedes ajustar los detalles de la base de datos con tu información.

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Ahora ejecuta la consulta a continuación para verificar los privilegios del usuario mediawiki. A continuación, puedes ver que el usuario mediawiki puede acceder a la base de datos mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Por último, escribe quit para salir del servidor MariaDB.

Descargando MediaWiki

En esta sección, descargarás el código fuente de MediaWiki 1.41 y configurarás el directorio de instalación para MediaWiki.

Ve al directorio /var/www y descarga el código fuente de MediaWiki con el comando curl a continuación. Asegúrate de visitar la página de descarga de MediaWiki para obtener la última versión.

cd /var/www/  
curl -O https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

Después de descargar, extrae el código fuente de MediaWiki y renombra el directorio a mediawiki. Con esto, tu directorio raíz de documentos para MediaWiki debería estar disponible en el directorio /var/www/mediawiki.

tar -xvzf mediawiki- *.tar.gz  
mv mediawiki-* / mediawiki/

Ahora, cambia la propiedad del directorio /var/www/mediawiki al usuario www-data y los permisos predeterminados a 0755.

sudo chown -R www-data:www-data /var/www/mediawiki  
sudo chmod 755 /var/www/mediawiki

Configurando el host virtual de Apache

Ahora que has descargado el código fuente de MediaWiki, el siguiente paso será crear un nuevo archivo de host virtual de Apache para ejecutar MediaWiki. Asegúrate de que tienes un nombre de dominio apuntando a tu servidor MediaWiki.

Primero, ejecuta el siguiente comando para habilitar el módulo rewrite en el servidor web Apache.

sudo a2enmod rewrite

Ahora crea un nuevo archivo de host virtual /etc/apache2/sites-available/mediawiki.conf con el siguiente comando del editor nano.

sudo nano /etc/apache2/sites-available/mediawiki.conf

Ingresa la siguiente configuración y asegúrate de cambiar la opción ServerName con tu nombre de dominio.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Guarda y cierra el archivo cuando termines.

A continuación, ejecuta el comando a continuación para activar el archivo de host virtual mediawiki.conf y verificar la sintaxis de Apache. Si tienes la sintaxis de Apache correcta, recibirás una salida Syntax is OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Por último, ejecuta el comando a continuación para reiniciar Apache y aplicar tus cambios. Con esto, tu instalación de MediaWiki debería estar lista.

sudo systemctl restart apache2

Asegurando MediaWiki con HTTPS

En esta guía, asegurarás MediaWiki con HTTPS. Si estás utilizando un dominio público, puedes usar certificados SSL gratuitos de Letsencrypt y configurar HTTPS automáticamente. Puedes generar certificados SSL y configurar HTTPS manualmente para usuarios de dominios locales.

Instala los paquetes certbot y python3-certbot-apache con el siguiente comando. Ingresa Y para confirmar la instalación.

sudo apt install certbot python3-certbot-apache

Después de que la instalación esté completa, ejecuta el comando certbot a continuación para generar certificados SSL/TLS para tu instalación de MediaWiki. Asegúrate de cambiar la dirección de correo electrónico y el nombre de dominio con tu información.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Verás certificados SSL/TLS en el directorio /etc/letsencrypt/live/domain.com. Tu instalación de MediaWiki debería estar automáticamente asegurada con HTTPS.

Instalando MediaWiki

Abre tu navegador web y visita tu nombre de dominio de MediaWiki como http://wiki.howtoforge.local. Haz clic en el enlace Configurar el wiki para comenzar la instalación.

Selecciona tu idioma para MediaWiki y haz clic en Continuar.

Haz clic en Continuar para aceptar los términos de MediaWiki.

Ingresa los detalles de tu base de datos MariaDB y haz clic en Continuar.

Para la configuración de la base de datos, deja esto como predeterminado y haz clic en Continuar.

Ahora ingresa el título de tu wiki y crea un nuevo usuario administrador y contraseña para tu instalación de MediaWiki. Luego, haz clic en Continuar nuevamente.

En las opciones adicionales de MediaWiki, ve a la sección Skins y selecciona tu skin/tema predeterminado. En este ejemplo, usaremos MinervaNeue.

Desplázate hacia abajo, deja otras configuraciones (o cámbialas según sea necesario), luego haz clic en Continuar.

Haz clic en Continuar para confirmar la instalación.

Después de que la instalación esté completa, haz clic en Continuar nuevamente.

Ahora el archivo LocalSettings.php se descargará automáticamente a tu máquina local. Sube ese archivo o crea el archivo LocalSettings.php con el mismo contenido que tienes.

En el archivo LocalSettings.php, cambia la opción predeterminada $wgDefaultSkin a minerva.

$wgDefaultSkin = “minerva”;

Ahora visita la página de inicio de tu MediaWiki y puedes ver a continuación la página de inicio del tema MinervaNeue.

Ahora puedes hacer clic en el botón de inicio de sesión en la parte superior derecha, luego ingresa tu usuario y contraseña de administrador.

Conclusión

¡Felicidades! Has completado la instalación de MediaWiki en el servidor Ubuntu 24.04. Tienes MediaWiki funcionando con el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP) y asegurado con HTTPS a través de certbot y Letsencrypt.