En este artículo vemos cómo instalar MediaWiki en Debian 9 Stretch paso a paso, de modo que podrás montar tu propio sistema de wiki sobre tu servidor o VPS Debian.
Tabla de contenidos
Antes de instalar MediaWiki en Debian 9 Stretch
Para completar esta pequeña guía de instalación de MediaWiki en Debian 9 Stretch debes partir de los siguientes requisitos mínimos:
- Un sistema Debian 9 Stretch actualizado.
- Un entorno o pila tipo LAMP (servidor web con PHP 7.3 ó superior y servicio de base de datos).
- Acceso a línea de comandos con root o un usuario con privilegios de sudo.
- Conexión a Internet.
Si no dispones del entorno necesario, puedes consultar previamente nuestra guía de instalación LAMP en Debian 9 Stretch.
También necesitaremos algunas herramientas del sistema que obtendremos desde los repositorios de Debian 9, para lo que actualizamos la información de los mismos:
~$ sudo apt update
E instalamos los paquetes necesarios:
~$ sudo apt install -y ca-certificates tar wget
Aunque puedes instalar MediaWiki como la página principal del servidor Debian 9 o como un servidor virtual adicional, por simplicidad en esta guía optaremos por instalar la aplicación como parte de la página web por defecto del sistema. Adaptar los cambios a otra integración en el servicio web es muy sencillo. También es recomendable trabajar sobre HTTPS.
Cómo descargar MediaWiki para Debian 9 Stretch
Vamos a descargar MediaWiki para Debian 9 Stretch desde la página oficial del proyecto:
Podemos descargar el paquete .tar.gz desde el navegador o copiar el enlace y usar el comando wget para realizar la descarga desde consola:
~$ wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.0.tar.gz
Cómo instalar MediaWiki en Debian 9 Stretch
Para instalar MediaWiki en Debian 9 Stretch seguiremos una serie de pasos para preparar el sistema y poder realizar la instalación vía web.
Preparación de los archivos de MediaWiki
Descomprimimos el paquete que acabamos de descargar directamente en su ubicación final:
~$ sudo tar xf mediawiki-1.36.0.tar.gz -C /var/www/html/
Como el nombre del directorio que se crea contiene números de versión, podemos renombrarlo o crear un enlace simbólico sin números. En este caso creamos un enlace simbólico:
~$ sudo ln -s /var/www/html/mediawiki-1.36.0/ /var/www/html/mediawiki
Servicio web
Preparación de PHP
MediaWiki requiere la presencia en Debian 9 Stretch de una serie de extensiones de PHP, como pueden ser apcu, gd, intl, mbstring o xml. Nos aseguraremos de su presencia instalando estas extensiones; por ejemplo, para PHP 7.4:
~$ sudo apt install -y php7.4-{apcu,gd,intl,mbstring,xml}
Si usas otra versión de PHP sustituye php7.4- en el comando anterior por lo que proceda.
Finalmente recargamos la configuración del servicio web o del servicio PHP (según corresponda) para aplicar los cambios:
~$ sudo systemctl reload apache2
Preparación de la base de datos
MediaWiki se apoya sobre el servicio de bases de datos que tengamos instalado en Debian 9. En este ejemplo tratamos con MariaDB/MySQL, por lo que conectaremos con el cliente de consola mysql y un usuario administrador para realizar los preparativos:
~$ mysql -u root -p
Creamos la base de datos para MediaWiki:
> create database my_wiki charset utf8mb4 collate utf8mb4_general_ci;
Hemos usado el nombre my_wiki porque es el valor por defecto que usa el instalador web, pero puedes especificar el que quieras.
Creamos el usuario en MariaDB y MySQL 5 así:
> create user mediawiki@localhost identified by 'XXXXXXXX';
Pero en MySQL 8 deberíamos especificar el plugin de autenticación:
> create user mediawiki@localhost identified with mysql_native_password by 'XXXXXXXX';
Y concedemos permisos al usuario sobre la base:
> grant all privileges on my_wiki.* to mediawiki@localhost;
Finalmente cerramos la sesión:
> exit
Instalación web
Para realizar la instalación vía web accedemos a la URL en la que quedará instalado MediaWiki, mostrándose una página que enlaza al instalador, o podemos añadir la ruta mw-config/index.php a la URL de MediaWiki.
Por ejemplo, la máquina en la que realizamos este tutorial es accesible en el dominio debian9.local, y al instalarse MediaWiki como parte de la página principal, la URL de la aplicación sería http://debian9.local.lan/mediawiki/. Por tanto, http://debian9.local.lan/mediawiki/mw-config/ es la URL del instalador:
En la página inicial del instalador elegimos el idioma para la instalación y para el Wiki.
Al continuar se mostrará una página de comprobación de requisitos del sistema:
Si has seguido los pasos previos, comprobarás que tu sistema Debian 9 Stretch cumple los requisitos para la instalación de MediaWiki.
El siguiente paso es conectar con la base de datos:
Introducimos la información para la conexión con la base de datos, es decir, base, usuario y contraseña tal y como los creamos anteriormente.
A continuación tenemos la opción de crear una cuenta distinta de la de la base de datos para el acceso web:
Pero como el usuario que hemos creado durante los preparativos no puede crear otros usuarios, dejamos la opción por defecto.
Pasamos a la configuración del nuevo wiki:
Asignaremos un nombre, un usuario administrador con contraseña, etc.
Se nos preguntará si queremos seguir configurando el wiki o pasar directamente a la instalación. No está de más ver el resto de opciones de instalación:
Algunas opciones son importantes, como la primera, que permite dejar el wiki completamente abierto o restingirlo más o menos, tanto a edición como a lectura. Otras opciones son el tipo de licencia en el pie de página, configuración del correo electrónico, apariencia, etc.
Llega el momento de realizar la instalación:
Tras unos instantes se mostrará un resumen con los resultados de las tareas de instalación:
Al continuar se producirá la descarga automática del archivo de configuración:
Tras la descarga de este archivo tendremos que instalarlo en el directorio de instalación de MediaWiki, ya sea copiándolo, moviéndolo, subiéndolo por FTP, copiándolo remotamente con scp, WinSCP, etc.
En cualquier caso, una vez instalado el archivo LocalSettings.php en su ubicación correspondiente, volvemos al navegador y seguimos el enlace «entrar en tu wiki«:
MediaWiki ya está instalado en tu sistema.
Siguiendo el enlace «Acceder» podremos iniciar sesión con el usuario administrador creado durante el proceso de instalación:
Y podremos trabajar tanto en la wiki como modificar opciones de configuración y preferencias:
¡Ya puedes trabajar con tu nueva aplicación wiki en Debian 9!
Conclusión
Ahora que sabes cómo instalar MediaWiki en Debian 9 Stretch ya puedes empezar a crear documentación y contenidos colaborativos en entornos locales o incluso a través de Internet.
En caso de dudas, preguntas, alguna sugerencia, correciones o algo que eches en falta, puedes dejar un comentario.
Ah, y si gracias a esta breve guía de instalación de MediaWiki en Debian 9 Stretch ya tienes listo tu wiki, ¡puedes invitarme a un café cuando quieras!
O también puedes dejar 1 $ de propina desde PayPal:
¡Gracias!
