Cómo instalar DokuWiki con Nginx y Let’s Encrypt SSL en Alma Linux

diciembre 17, 2023

DokuWiki es un software wiki de código abierto basado en web, diseñado principalmente para sistemas Linux. Hace posible la documentación colaborativa y la gestión del conocimiento permitiendo a los usuarios crear y editar contenidos a través de una interfaz web sencilla e intuitiva. DokuWiki destaca por su ligereza y facilidad de instalación, ya que no requiere una base de datos, lo que lo hace muy adecuado para organizaciones o proyectos más pequeños. Sus sólidas capacidades de formato de texto, control de versiones y amplio ecosistema de plugins la convierten en una herramienta versátil para crear y mantener documentación, bases de conocimiento y sitios web en un entorno Linux.

Este tutorial te mostrará cómo instalar DokuWiki con Nginx en Alma Linux.

Requisitos previos

Un servidor con Alma Linux 8.
Un nombre de dominio válido apuntado con la IP de tu servidor.
Una contraseña de root configurada en el servidor.

Instalar Nginx y PHP

Por defecto, la última versión de PHP no está incluida en el repositorio por defecto de Alma Linux 8. Así que tendrás que instalar el repositorio EPEL y Remi en tu sistema.

Puedes instalar ambos ejecutando el siguiente comando:

dnf install epel-release -y
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y

Una vez instalados ambos paquetes, activa el repositorio PHP Remi con el siguiente comando:

dnf module enable php:remi-7.4 -y

Deberías ver la siguiente salida:

Dependencies resolved.
==============================================================================================================================================
 Package                           Architecture                     Version                           Repository                         Size
==============================================================================================================================================
Enabling module streams:
 php                                                                remi-7.4                                                                 

Transaction Summary
==============================================================================================================================================

Complete!

A continuación, instala el servidor web Nginx, PHP y otras extensiones necesarias con el siguiente comando:

dnf install nginx php php-cli php-fpm php-gd php-xml php-zip -y

Una vez instalados todos los paquetes, edita el archivo de configuración PHP-FPM y cambia la escucha, el usuario y el grupo:

nano /etc/php-fpm.d/www.conf

Cambia las siguientes líneas:

user = nginx
group = nginx

Guarda y cierra el archivo y, a continuación, inicia y habilita el servicio Nginx y PHP-FPM mediante el siguiente comando:

systemctl start nginx php-fpm
systemctl enable nginx php-fpm

También puedes verificar la versión de PHP con el siguiente comando:

php --version

Obtendrás la siguiente salida:

PHP 7.4.28 (cli) (built: Feb 15 2022 13:23:10) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.28, Copyright (c), by Zend Technologies

Instalar DokuWiki en Alma Linux 8

A continuación, tendrás que descargar la última versión de DokuWiki desde su sitio web oficial. Puedes descargarla con el siguiente comando:

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

Una vez completada la descarga, crea un directorio para DokuWiki dentro de la raíz web de Nginx:

mkdir /var/www/html/dokuwiki

A continuación, extrae el archivo descargado con el siguiente comando:

tar xvf dokuwiki-stable.tgz

A continuación, mueve el directorio extraído al directorio DokuWiki:

mv dokuwiki-2020-07-29/* /var/www/html/dokuwiki/

A continuación, cambia la propiedad del directorio DokuWiki a Nginx:

chown -R nginx:nginx /var/www/html/dokuwiki

Una vez que hayas terminado, puedes pasar al siguiente paso.

Crear un host virtual Nginx para DokuWiki

A continuación, crea un archivo de configuración Nginx para DokuWiki utilizando el siguiente comando:

nano /etc/nginx/conf.d/dokuwiki.conf

Añade las siguientes líneas:

server {
    listen 80;
    server_name wiki.example.com;
    root /var/www/html/dokuwiki;
    index index.html index.htm index.php doku.php;
    
    client_max_body_size 15M;
    client_body_buffer_size 128K;
    
    location / {
        try_files $uri $uri/ @dokuwiki;
    }
    
    location ^~ /conf/ { return 403; }
    location ^~ /data/ { return 403; }
    location ~ /\.ht { deny all; }
    
    location @dokuwiki {
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1 last;
    }
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php-fpm/www.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Guarda y cierra el archivo y luego verifica que Nginx no tenga ningún error de sintaxis con el siguiente comando:

nginx -t

Obtendrás la siguiente salida:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Por último, reinicia el servicio Nginx para aplicar los cambios:

systemctl restart nginx

También puedes comprobar el estado del Nginx utilizando el siguiente comando:

systemctl status nginx

Obtendrás la siguiente salida:

? nginx.service - The nginx HTTP and reverse proxy server
   Loaded: loaded (/usr/lib/systemd/system/nginx.service; disabled; vendor preset: disabled)
  Drop-In: /usr/lib/systemd/system/nginx.service.d
           ??php-fpm.conf
   Active: active (running) since Sat 2022-03-26 04:26:32 UTC; 4s ago
  Process: 5020 ExecStart=/usr/sbin/nginx (code=exited, status=0/SUCCESS)
  Process: 5018 ExecStartPre=/usr/sbin/nginx -t (code=exited, status=0/SUCCESS)
  Process: 5017 ExecStartPre=/usr/bin/rm -f /run/nginx.pid (code=exited, status=0/SUCCESS)
 Main PID: 5022 (nginx)
    Tasks: 2 (limit: 11412)
   Memory: 3.8M
   CGroup: /system.slice/nginx.service
           ??5022 nginx: master process /usr/sbin/nginx
           ??5023 nginx: worker process

Mar 26 04:26:32 linux systemd[1]: nginx.service: Succeeded.
Mar 26 04:26:32 linux systemd[1]: Stopped The nginx HTTP and reverse proxy server.
Mar 26 04:26:32 linux systemd[1]: Starting The nginx HTTP and reverse proxy server...
Mar 26 04:26:32 linux nginx[5018]: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
Mar 26 04:26:32 linux nginx[5018]: nginx: configuration file /etc/nginx/nginx.conf test is successful
Mar 26 04:26:32 linux systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Mar 26 04:26:32 linux systemd[1]: Started The nginx HTTP and reverse proxy server.

Accede a la interfaz web de DokuWiki

Ahora, abre tu navegador web y accede al asistente de instalación web de DokuWiki utilizando la URL http://wiki.example.com/install.php. Obtendrás la siguiente página:

Proporciona toda la información requerida como nombre de superusuario, correo electrónico, contraseña. A continuación, pulsa el botón Guardar. Una vez que la instalación se haya completado con éxito, deberías ver la siguiente página:

Ahora, haz clic en tu nuevo DokuWiki. Deberías ver la siguiente página:

Ahora, haz clic en el botón de inicio de sesión. Serás redirigido a la siguiente página:

Ahora, proporciona tu nombre de usuario y contraseña de Admin. A continuación, haz clic en el botón Iniciar sesión. Deberías ver el panel de control de DokuWiki en la siguiente página:

Tras una configuración correcta, elimina el archivo install.php del directorio raíz de DokuWiki:

rm -rf /var/www/html/dokuwiki/install.php

Asegura DokuWiki con Let’s Encrypt

Es una buena idea asegurar el sitio web wiki con Let’s Encrypt. Para ello, necesitarás instalar el paquete Certbot en tu servidor. Puedes instalarlo ejecutando el siguiente comando:

dnf install epel-release -y
dnf install certbot -y

A continuación, ejecuta el siguiente comando para instalar Let’s Encrypt SSL en tu sitio web:

certbot --nginx -d wiki.example.com

Se te pedirá que proporciones tu dirección de correo electrónico y que aceptes las condiciones del servicio:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Account registered.
Requesting a certificate for wiki.example.com
Performing the following challenges:
http-01 challenge for wiki.example.com
Waiting for verification.
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/nginx/conf.d/dokuwiki.conf
Redirecting all traffic on port 80 to ssl in /etc/nginx/conf.d/dokuwiki.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://wiki.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Subscribe to the EFF mailing list (email: [email protected]).


IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/wiki.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/wiki.example.com/privkey.pem
   Your certificate will expire on 2022-04-09. To obtain a new or
   tweaked version of this certificate in the future, simply run
   certbot again with the "certonly" option. To non-interactively
   renew *all* of your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

Ahora puedes acceder a tu sitio web de forma segura utilizando la URL https://wiki.example.com.

Conclusión

¡Enhorabuena! Has instalado y configurado correctamente DokuWiki en el servidor Alma Linux 8. Ahora puedes crear tu propio sitio wiki fácilmente utilizando DokuWiki. No dudes en preguntarme si tienes alguna duda.

Cómo instalar DokuWiki con Nginx y Let’s Encrypt SSL en Alma Linux

Requisitos previos

Instalar Nginx y PHP

Instalar DokuWiki en Alma Linux 8

Crear un host virtual Nginx para DokuWiki

Accede a la interfaz web de DokuWiki

Asegura DokuWiki con Let’s Encrypt

Conclusión

También te podría gustar...

Entradas recientes

Cómo instalar DokuWiki con Nginx y Let’s Encrypt SSL en Alma Linux

Requisitos previos

Instalar Nginx y PHP

Instalar DokuWiki en Alma Linux 8

Crear un host virtual Nginx para DokuWiki

Accede a la interfaz web de DokuWiki

Asegura DokuWiki con Let’s Encrypt

Conclusión

También te podría gustar...

Cómo actualizar de Debian 10 a Debian 11

Cómo instalar BookWyrm en un servidor Debian 12

Cómo instalar Bludit CMS con NGINX en Debian 9

Entradas recientes