Cómo instalar MediaWiki en Debian 12

MediaWiki es un software wiki de código abierto utilizado por los sitios wiki más grandes, como Wikipedia y Wikimedia. Es un software wiki gratuito que se puede utilizar como plataforma de colaboración y documentación. Es una implementación wiki poderosa, escalable y rica en funciones.

Este tutorial te mostrará cómo instalar MediaWiki con el LAMP Stack (Apache, MariaDB y PHP) en el servidor Debian 12. Además, también te mostraremos cómo asegurar MediaWiki con HTTPS a través de Certbot y Letsencrypt.

Prerrequisitos

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

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

Instalando el LAMP Stack

MediaWiki es un software de código abierto basado en PHP con MySQL/MariaDB como almacenamiento de datos. Actualmente, la versión estable actual de MediaWiki (1.41) requiere al menos PHP 7.3.4 o superior y MariaDB 10.3.0. En cuanto a servidores web, puedes usar Apache o Nginx.

En esta sección, instalarás el LAMP Stack (Apache, MariaDB y PHP) que se utilizará para ejecutar tu instalación de MediaWiki.

Primero, actualiza tu repositorio Debian con el siguiente comando.

sudo apt update

Una vez que el repositorio esté actualizado, instala las dependencias del LAMP Stack con el siguiente comando. Ingresa Y para confirmar la instalación.

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

Una vez que la instalación esté completa, verifica el servicio de Apache y MariaDB para asegurarte de que ambos servicios estén en funcionamiento.

Verifica el servidor web Apache con el siguiente comando. Si obtienes la salida habilitada, esto confirma que Apache está habilitado y se iniciará automáticamente al arrancar. Al ejecutarse, verás la salida activa (en funcionamiento).

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

A continuación, verifica el servidor de base de datos MariaDB con el siguiente comando. La salida debería ser similar, una salida habilitada confirma que MariaDB está habilitado, y activo (en funcionamiento) confirma que MariaDB está funcionando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por último, verifica la versión de PHP y lista los módulos habilitados con el siguiente comando. Verás PHP 8.2 instalado en tu servidor Debian.

php -v  
php -m

Configurando PHP

Después de haber instalado el LAMP Stack, configurarás tu instalación de PHP editando el archivo php.ini y cambiando algunos parámetros predeterminados para MediaWiki.

Para configurar PHP, abre la configuración de PHP /etc/php/8.2/apache2/php.ini con el siguiente comando del editor nano.

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

Cambia la configuración predeterminada con lo siguiente y asegúrate de ajustar tanto date.timezone como memory_limit con tu entorno actual.

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

Guarda y sal del archivo.

Ahora ejecuta el siguiente comando para reiniciar el servicio de Apache y aplicar tus cambios.

sudo systemctl restart apache2

Configurando el Servidor MariaDB

Con PHP configurado, el siguiente paso es asegurar el servidor MariaDB y crear una nueva base de datos y usuario para MediaWiki. En este ejemplo, asegurarás el servidor MariaDB utilizando el comando de línea mariadb-secure-installation y crearás una nueva base de datos y usuario a través del cliente de MariaDB.

Para asegurar la instalación del servidor MariaDB, ejecuta el comando mariadb-secure-installation a continuación.

sudo mariadb-secure-installation

Ahora ingresa Y para aceptar o n para rechazar la nueva configuración en el servidor MariaDB:

• La instalación predeterminada de MariaDB viene sin una 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 la tabla y aplicar los nuevos cambios.

Después de haber asegurado la implementación del servidor MariaDB, inicia sesión en el servidor MariaDB utilizando el comando mariadb a continuación. Ingresa tu contraseña de root de MariaDB cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos y usuario de MariaDB para MediaWiki. En este ejemplo, crearás una nueva base de datos mediawikidb, un usuario mediawiki con la contraseña mediawikipassdb. Puedes ajustar lo siguiente con tus credenciales.

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

A continuación, ejecuta la siguiente consulta para verificar los privilegios del usuario de MariaDB mediawiki. Asegúrate de que el usuario mediawiki pueda acceder a la base de datos mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Por último, escribe quit para salir de MariaDB cuando termines.

Descargando el Código Fuente de MediaWiki

Ahora que las dependencias están instaladas y configuradas, puedes instalar MediaWiki. Hay múltiples versiones de MediaWiki: estable, legado y LTS. En este caso, instalarás la última versión estable de MediaWiki 1.41.

Muévete al directorio /var/www y descarga el código fuente de MediaWiki a través del comando wget a continuación. Asegúrate de visitar la página de descarga de MediaWiki para obtener la última versión.

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

Una vez descargado, extrae el código fuente con el siguiente comando. Luego, renombra el directorio extraído a mediawiki. Así, el directorio DocumentRoot para MediaWiki estará en /var/www/mediawiki.

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

Por último, cambia la propiedad del directorio /var/www/mediawiki al usuario www-data y cambia el permiso a 0755.

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

Configurando el Host Virtual de Apache

Así que ahora has descargado el código fuente de MediaWiki, crearás un nuevo archivo de host virtual de Apache para ejecutar MediaWiki en esta sección. Así que asegúrate de estar equipado con el nombre de dominio apuntando a la dirección IP de tu servidor. Para producción, compra el dominio público, o también puedes usar el nombre de dominio local.

Antes de comenzar, habilita el módulo de reescritura de Apache con el siguiente comando.

sudo a2enmod rewrite

Ahora crea una nueva configuración de host virtual de Apache /etc/apache2/sites-available/mediawiki.conf con el comando del editor nano a continuación.

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

Inserta la siguiente configuración y asegúrate de cambiar la opción ServerName con tu nombre de dominio y la ruta de ambos registros de acceso y error.

  
  
 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 el archivo y sal del editor.

A continuación, activa el archivo de host virtual mediawiki.conf y verifica tu sintaxis de Apache con el siguiente comando. Si tienes una sintaxis de Apache adecuada, verás una salida como Syntax OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Por último, reinicia el servidor web Apache para aplicar el nuevo host virtual para MediaWiki. Una vez reiniciado, tu instalación de MediaWiki debería estar lista.

sudo systemctl restart apache2

Asegurando MediaWiki con HTTPS

Ahora que has creado una configuración de host virtual de Apache para MediaWiki, aseguraremos tu instalación con HTTPS a través de Certbot y letsencrypt. Esto solo se aplica si estás utilizando el dominio público, pero si estás utilizando el dominio local, puedes generar certificados autofirmados y aplicar HTTPS manualmente.

Instala Certbot y el complemento Certbot Apache con el siguiente comando. Escribe Y para confirmar la instalación.

sudo apt install certbot python3-certbot-apache

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

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

Después de que el proceso haya finalizado, tu certificado estará disponible en el directorio /etc/letsencrypt/live/domain.com, mientras que tu host virtual también estará configurado con HTTPS.

Instalando MediaWiki

Abre tu navegador web preferido y visita tu nombre de dominio, como http://wiki.howtoforge.local/. Si todo va bien, deberías ver la página de bienvenida de MediaWiki. Haz clic en el enlace configurar el wiki.

Selecciona el idioma predeterminado para tu MediaWiki y haz clic en Continuar.

Para las verificaciones del entorno, asegúrate de que tu sistema cumpla con los requisitos de MediaWiki. Luego, haz clic en Continuar nuevamente.

Selecciona la base de datos como MariaDB e ingresa tu nombre, usuario y contraseña. Luego, haz clic en Continuar para proceder.

A continuación, ingresa tu nombre de usuario de administrador, correo electrónico y contraseña para MediaWiki, luego haz clic en Continuar.

Para configuraciones adicionales, selecciona el tema predeterminado que deseas usar, luego haz clic en Continuar para proceder con la instalación.

Haz clic en Continuar para confirmar la instalación de MediaWiki.

Una vez que la instalación esté completa, el archivo LocalSettings.php se descargará automáticamente a tu computadora local y verás una instrucción para subir el archivo a tu directorio de instalación de MediaWiki.

Regresa a tu terminal y ejecuta el siguiente comando para crear un nuevo archivo LocalSettings.php.

sudo -u www-data nano /var/www/mediawiki/LocalSettings.php

Abre el archivo LocalSettings.php que descargaste y copia y pega el código PHP en tu servidor. Luego, guarda el archivo y sal.

Regresa a tu navegador web y haz clic en el enlace para entrar al wiki. Verás la página de inicio predeterminada de MediaWiki que has instalado.

Conclusión

¡Felicidades! Ahora has instalado con éxito MediaWiki en el servidor Debian 12. Has instalado MediaWiki con el LAMP Stack (Apache, MariaDB y PHP) y asegurado MediaWiki con HTTPS de Letsencrypt.