DokuWiki · 7 min read · Dec 14, 2025

Cómo instalar DokuWiki con Nginx y Let's Encrypt SSL en FreeBSD 12

DokuWiki es un software wiki de código abierto, fácil de usar y altamente versátil que no requiere una base de datos. A los usuarios les encanta por su sintaxis limpia y legible. La facilidad de mantenimiento, respaldo e integración lo convierte en el favorito de los administradores. Los controles de acceso integrados y los conectores de autenticación hacen que DokuWiki sea especialmente útil en el contexto empresarial y un gran número de complementos contribuidos por su vibrante comunidad permiten una amplia gama de casos de uso más allá de un wiki tradicional. Este tutorial te mostrará cómo instalar DokuWiki en un servidor FreeBSD 12.

Requisitos

Asegúrate de que tu servidor cumpla con los siguientes requisitos.

  • Software de servidor web que soporte PHP (Apache, NGINX, IIS, Lighttpd, LiteSpeed)
  • Versión de PHP 5.6 o posterior, se recomiendan versiones más recientes.

Prerrequisitos

  • Un sistema operativo FreeBSD 12.
  • Un usuario no root con privilegios de sudo.

Pasos iniciales

Verifica la versión de FreeBSD.

uname -ro  
# FreeBSD 12.1-RELEASE

Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque asegura que tengas las últimas actualizaciones y correcciones de seguridad para los paquetes de software predeterminados de tu sistema operativo.

freebsd-update fetch install  
pkg update && pkg upgrade -y

Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo FreeBSD 12.

pkg install -y sudo vim unzip curl wget bash bash-completion socat git

Crea una nueva cuenta de usuario con tu nombre de usuario preferido, usamos johndoe.

adduser  
# Nombre de usuario: johndoe  
# Nombre completo: John Doe  
# Uid (Deja vacío para predeterminado):   
# Grupo de inicio de sesión [johndoe]:   
# El grupo de inicio de sesión es johndoe. ¿Invitar a johndoe a otros grupos? []: wheel  
# Clase de inicio de sesión [default]:   
# Shell (sh csh tcsh nologin) [sh]: bash  
# Directorio de inicio [/home/johndoe]:   
# Permisos del directorio de inicio (Deja vacío para predeterminado):   
# ¿Usar autenticación basada en contraseña? [yes]:   
# ¿Usar una contraseña vacía? (yes/no) [no]:   
# ¿Usar una contraseña aleatoria? (yes/no) [no]:   
# Introduce la contraseña: your_secure_password  
# Introduce la contraseña nuevamente: your_secure_password  
# ¿Bloquear la cuenta después de la creación? [no]:   
# ¿OK? (yes/no): yes  
# ¿Agregar otro usuario? (yes/no): no  
# ¡Adiós!

Ejecuta el comando visudo y descomenta la línea %wheel ALL=(ALL) ALL, para permitir que los miembros del grupo wheel ejecuten cualquier comando.

visudo  
  
# Descomentar eliminando el signo de hash (#)  
%wheel ALL=(ALL) ALL

Ahora, cambia a tu nuevo usuario creado con el comando su.

su - johndoe

NOTA: Reemplaza johndoe con tu nombre de usuario.

Configura la zona horaria.

sudo tzsetup

Paso 1 - Instalar PHP y extensiones de PHP

Instala PHP, así como las extensiones de PHP necesarias.

sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-pecl-imagick php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-mysqli php72-phar php72-opcache php72-pdo_pgsql

Verifica la versión de PHP.

php --version  
# PHP 7.2.17 (cli) (built: Apr 13 2019 01:13:32) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

Crea un enlace simbólico de php.ini-production a php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Habilita e inicia PHP-FPM.

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Paso 2 - Instalar el cliente acme.sh y obtener el certificado Let’s Encrypt (opcional)

Asegurar tu sitio con HTTPS no es necesario, pero es una buena práctica asegurar el tráfico de tu sitio. Para obtener un certificado TLS de Let’s Encrypt, utilizaremos el cliente acme.sh. Acme.sh es un software de shell UNIX simple para obtener certificados TLS de Let’s Encrypt con cero dependencias.

Descarga e instala acme.sh:

sudo pkg install -y acme.sh

Verifica la versión de acme.sh:

acme.sh --version  
# v2.8.5

Obtén certificados RSA y ECC/ECDSA para tu dominio/nombre de host: 

# RSA 2048  
sudo acme.sh --issue --standalone -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone -d example.com --keylength ec-256

Si deseas certificados falsos para pruebas, puedes agregar la bandera --staging a los comandos anteriores.

Después de ejecutar los comandos anteriores, tus certificados y claves estarán en:

  • Para RSA: directorio /home/username/example.com.
  • Para ECC/ECDSA: directorio /home/username/example.com_ecc.

Para listar tus certificados emitidos, puedes ejecutar:

acme.sh --list

Crea un directorio para almacenar tus certificados. Usaremos el directorio /etc/letsencrypt.

sudo mkdir -p /etc/letsecnrypt/example.com  
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Instala/copia los certificados al directorio /etc/letsencrypt.

# RSA  
sudo acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"  
# ECC/ECDSA  
sudo acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

Todos los certificados se renovarán automáticamente cada 60 días.

Después de obtener los certificados, sal del usuario root y regresa al usuario sudo regular:

exit

Paso 3 - Instalar y configurar Nginx

DokuWiki funcionará en cualquier servidor web que soporte PHP. En este tutorial, utilizaremos Nginx. Si prefieres Apache u otro servidor web, puedes usar eso en lugar de Nginx.

Instala Nginx.

sudo pkg install -y nginx

Verifica la versión de Nginx.

nginx -v  
# versión de nginx: nginx/1.16.1

Habilita e inicia el servicio Nginx.

sudo sysrc nginx_enable=yes  
sudo service nginx start

Ejecuta sudo vim /usr/local/etc/nginx/dokuwiki.conf y configura el servidor virtual Nginx para DokuWiki.

sudo vim /usr/local/etc/nginx/dokuwiki.conf

Copia/pega la siguiente configuración de Nginx y guárdala:

server {  
    
    listen [::]:443 ssl;  
    listen 443 ssl;
    listen [::]:80;
    listen 80;
    # RSA  
    ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;  
    ssl_certificate_key /etc/letsencrypt/example.com/private.key;  
    # ECC  
    ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;  
    ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;  

    server_name wiki.example.com;
    root /usr/local/www/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 $uri/ /doku.php;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param REDIRECT_STATUS 200;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Guarda el archivo y sal de tu editor.

Incluye el archivo dokuwiki.conf en el archivo principal nginx.conf ejecutando sudo vim /usr/local/etc/nginx/nginx.conf y agrega la siguiente línea al bloque http {}.

include dokuwiki.conf;

Prueba nuestros cambios de configuración de Nginx.

sudo nginx -t

Recarga Nginx.

sudo service nginx reload

Paso 4 - Instalar DokuWiki

Crea un directorio raíz de documentos:

sudo mkdir -p /usr/local/www/dokuwiki

Navega al directorio raíz de documentos:

cd /usr/local/www/dokuwiki

Descarga la última versión estable de DokuWiki desde la página de descarga de DokuWiki:

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

Descomprime el archivo tar de DokuWiki:

sudo tar xvf dokuwiki-stable.tgz  
sudo rm dokuwiki-stable.tgz  
sudo mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .  
sudo rmdir dokuwiki-2018-04-22b/

Cambia la propiedad del directorio /var/www/dokuwiki a www:

sudo chown -R www:www /usr/local/www/dokuwiki

Reinicia PHP-FPM :

sudo service php-fpm restart

Abre el script de configuración de DokuWiki, install.php, en tu navegador y configura DokuWiki. El script de configuración verifica la disponibilidad de las funciones PHP requeridas y verifica los permisos de archivo necesarios. También crea una cuenta de administrador inicial y una política ACL inicial. Para ejecutar el instalador, abre http://wiki.example.com/install.php en el navegador y sigue las instrucciones.

Paso 5 - Acceder a la interfaz web de DokuWiki

Abre tu navegador web y escribe la URL http://example.com/install.php. Serás redirigido a la siguiente página:

Instalador de DokuWiki

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

Establecer nombre de usuario y contraseña

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

DokuWiki instalado con éxito

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

Iniciar sesión

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

Bienvenido a DokuWiki

Después de una configuración exitosa, elimina el archivo install.php del directorio raíz de DokuWiki:

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

¡Felicidades! Has instalado y configurado con éxito DokuWiki en el servidor FreeBSD 12. Ahora puedes crear fácilmente tu propio sitio wiki utilizando DokuWiki.

Enlaces

Share: X/Twitter LinkedIn
#DokuWiki

Recibe nuevas publicaciones en tu bandeja de entrada.

No spam. Cancela la suscripción en cualquier momento.