Cómo instalar DokuWiki en Debian 12

DokuWiki es un software wiki simple y versátil de código abierto que no requiere una base de datos. Es conocido por su facilidad de mantenimiento, legibilidad y gestión de usuarios, lo que lo hace ideal para crear y gestionar documentación en entornos corporativos o colaborativos. Impulsado por PHP, su versátil software wiki y los controles de acceso integrados (ACL) admiten los principales controladores de autenticación. DokuWiki proporciona una fácil administración, es fácil de instalar, mantener y hacer copias de seguridad de un host a otro.

En esta guía, te guiaremos a través de la instalación de DokuWiki en el servidor Debian 12. Instalarás DokuWiki con LAMP Stack (Apache2, MariaDB y PHP), UFW y certificados SSL/TLS a través de Letsencrypt.

Prerrequisitos

Asegúrate de tener lo siguiente para continuar con esta guía:

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

Instalando Dependencias

Por defecto, el paquete DokuWiki está disponible en el repositorio de Debian. Pero, para asegurarte de que tienes la última versión de DokuWiki instalada, instalarás DokuWiki manualmente en tu servidor Debian.

En esta sección, instalarás las dependencias para DokuWiki, incluidos los paquetes de LAMP Stack (Apache2, MariaDB y PHP), UFW y Certbot.

Antes de comenzar, actualiza tu repositorio de Debian usando el siguiente comando.

sudo apt update

Instala los paquetes de LAMP Stack, UFW y Certbot usando el siguiente comando apt install. Escribe Y y presiona ENTER cuando se te solicite.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

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

Ejecuta el siguiente comando para verificar el servicio apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Cuando apache2 esté en funcionamiento, deberías obtener una salida ‘active (running)’. Y la salida ‘enabled’ confirma que apache2 se iniciará al arrancar el sistema.

Ahora ejecuta el siguiente comando para verificar el servicio mariadb.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Asegúrate de que el servicio mariadb esté ‘enabled’ y ‘active (running)’ en tu máquina Debian.

Configurando UFW

En esta guía, asegurarás tu servidor Debian con UFW (Uncomplicated Firewall). En este caso, debes abrir el puerto SSH para tu acceso remoto, y los puertos para los protocolos HTTP y HTTPS para ejecutar la instalación de DokuWiki.

Ejecuta el siguiente comando para agregar los perfiles OpenSSH y ‘WWW Full‘ a UFW.

El perfil OpenSSH abrirá el puerto SSH predeterminado 22, mientras que el perfil ‘WWW Full’ abre ambos puertos HTTP y HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Ahora, ejecuta el siguiente comando para iniciar y habilitar UFW en tu máquina Debian.

sudo ufw enable

Ingresa y cuando se te pida confirmar, deberías obtener una salida como ‘El firewall está activo y habilitado al inicio del sistema‘. El UFW se ejecutará automáticamente al arrancar el sistema.

Por último, ejecuta el siguiente comando para verificar el estado de UFW. Asegúrate de que ambos perfiles OpenSSH y ‘WWW Full’ estén listados en tus reglas habilitadas de UFW.

sudo ufw status

Configurando php.ini

En la siguiente sección, configurarás PHP modificando el archivo php.ini predeterminado y ajustando algunas de las configuraciones para la instalación de DokuWiki.

Ejecuta el siguiente comando del editor nano para abrir el archivo de configuración de PHP ‘/etc/php/8.2/apache2/php.ini‘.

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

Cambia la configuración predeterminada con lo siguiente. Asegúrate de ajustar el parámetro memory_limit con la RAM actual de tu servidor.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Guarda y cierra el archivo cuando termines.

Ahora, ejecuta el comando systemctl a continuación para reiniciar el servicio apache2 y aplicar los efectos de tus cambios.

sudo systemctl restart apache2

Configurando el Servidor MariaDB

Ahora que has configurado PHP, el siguiente paso es configurar la instalación de tu servidor MariaDB, luego crear una nueva base de datos y un usuario que utilizará DokuWiki.

Comienza el proceso de configuración de MariaDB ejecutando el comando mariadb-secure-installation a continuación.

sudo mariadb-secure-installation

Ingresa Y cuando se te pida aplicar la nueva configuración a MariaDB, o también puedes escribir n para No para rechazarla. A continuación, algunas de las configuraciones de MariaDB que se te solicitarán:

• 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 la tabla y aplicar los nuevos cambios.

Después de que la configuración de MariaDB haya finalizado, necesitas crear una nueva base de datos y un usuario que será utilizado por DokuWiki.

Inicia sesión en el servidor MariaDB ejecutando 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 dokuwikidb, usuario dokuwiki, con la contraseña ‘p4ssword‘. Asegúrate de cambiar la contraseña por tu nueva contraseña.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

A continuación, verifica el usuario dokuwiki para asegurarte de que tiene privilegios sobre la base de datos dokuwikidb.

SHOW GRANTS FOR dokuwiki@localhost;

En la siguiente salida, has configurado al usuario dokuwiki con todos los privilegios para la base de datos dokuwikidb.

Por último, escribe quit para salir del servidor MariaDB y pasar al siguiente paso.

Descargando el Código Fuente de DokuWiki

En esta sección, descargarás el código fuente de DokuWiki y configurarás el directorio de instalación con los permisos adecuados.

Pasa al directorio /var/www/ y descarga la última versión estable de DokuWiki usando el comando wget a continuación.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Ahora extrae el archivo dokuwiki-stable.tgz y renombra el directorio extraído a dokuwiki. Esto significa que tu directorio de instalación de DokuWiki estará disponible en /var/www/dokuwiki.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Por último, ejecuta el comando a continuación para cambiar la propiedad del directorio /var/www/dokuwiki al usuario www-data y grupo www-data. De esta manera, tu servidor web Apache2 podrá leer el código fuente de DokuWiki.

sudo chown -R www-data:www-data /var/www/dokuwiki

Configurando el Host Virtual de Apache2

Después de descargar DokuWiki, ahora crearás un nuevo archivo de host virtual de Apache2 para ejecutar DokuWiki. Asegúrate de que tu nombre de dominio esté listo antes de comenzar. En este ejemplo, usaremos el dominio wiki.howtoforge.local.

Ahora, ejecuta el comando del editor nano a continuación para crear una nueva configuración de host virtual de Apache2 /etc/apache2/sites-available/dokuwiki.conf.

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

Inserta la siguiente configuración y asegúrate de cambiar el nombre de dominio wiki.howtoforge.local por tu dominio.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined  

Cuando termines, guarda y cierra el archivo.

A continuación, ejecuta el siguiente comando para habilitar el host virtual dokuwiki.conf y verificar la sintaxis de Apache para asegurarte de que no haya errores.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Si tienes la sintaxis correcta y no hay errores, verás una salida ‘Syntax OK‘.

Por último, ejecuta el comando a continuación para reiniciar el servidor Apache2 y aplicar tus modificaciones.

sudo systemctl restart apache2

Asegurando DokuWiki con Certificados SSL/TLS

En este punto, tu DokuWiki está en funcionamiento y accesible. Pero para asegurarte de que tu instalación sea segura, configurarás certificados SSL/TLS a través de Letsencrypt.

Ejecuta el comando certbot a continuación para generar certificados SSL/TLS para tu nombre de dominio DokuWiki. Asegúrate de cambiar la dirección de correo electrónico y el nombre de dominio por tu información.

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

Una vez que el proceso haya finalizado, tu instalación de DokuWiki debería estar configurada automáticamente con HTTPS. Y tus certificados SSL/TLS deberían estar disponibles en el directorio /etc/letsencrypt/live/yourdomain.com.

Instalando DokuWiki a través del Instalador Web

Abre tu navegador web y visita tu nombre de dominio para la instalación de DokuWiki, como https:/wiki.howtoforge.local/install.php. Deberías ver el instalador web de DokuWiki.

Selecciona la opción Habilitar ACL, ingresa tu usuario administrador, correo electrónico y contraseña para DokuWiki, y luego haz clic en Guardar.

Una vez que la instalación sea exitosa, deberías obtener una salida ‘La configuración se completó con éxito.‘.

Ahora vuelve a tu terminal y elimina el script install.php usando el siguiente comando.

sudo rm /var/www/dokuwiki/install.php

A continuación, haz clic en el enlace ‘tu nuevo DokuWiki‘ para continuar. Y deberías obtener la página de inicio de DokuWiki como la siguiente.

Ahora haz clic en el botón Iniciar sesión y deberías obtener la página de inicio de sesión de DokuWiki como la siguiente.

Ingresa tu usuario administrador y contraseña, luego haz clic en Iniciar sesión. Cuando sea exitoso, deberías presentarte con el panel de control de DokuWiki.

Conclusión

¡Felicidades! Ahora has completado la instalación de DokuWiki en el servidor Debian 12. Has instalado DokuWiki con el LAMP Stack (Apache2, MariaDB y PHP). También has asegurado tu instalación de DokuWiki con UFW (Uncomplicated Firewall) y certificados SSL/TLS de Letsencrypt.