¿Te has visto alguna vez perdido entre cientos de notas dispersas, archivos de texto sin formato y capturas de pantalla que no llevan a ninguna parte? En pleno 2026, la gestión del conocimiento no es solo una opción, es una necesidad crítica para cualquier profesional técnico o entusiasta del self-hosting.
La saturación de información nos obliga a centralizar nuestros procesos. Wiki.js se ha consolidado como el motor de wiki más potente y moderno del mercado, superando a opciones clásicas como MediaWiki o DokuWiki gracias a su interfaz basada en Node.js y su compatibilidad nativa con múltiples motores de renderizado.
En esta guía, vamos a desplegar un servidor de Wiki.js desde cero, optimizado para entornos de alto rendimiento. He probado personalmente esta configuración en servidores VPS de gama media y los resultados en tiempos de respuesta son, sencillamente, imbatibles si se configura correctamente.
Requisitos de hardware y software en 2026
Para que Wiki.js funcione con fluidez, especialmente si planeas manejar miles de páginas o activos multimedia pesados, no podemos escatimar en recursos básicos. Aunque es ligero, el motor de búsqueda interno y la renderización de Markdown consumen ciclos de CPU.
Especificaciones técnicas recomendadas
- Procesador: Mínimo 2 vCPUs (recomendado 4 vCPUs para búsquedas indexadas rápidas).
- Memoria RAM: 2 GB como base, aunque 4 GB es el punto dulce en 2026.
- Almacenamiento: 20 GB SSD/NVMe para el sistema y base de datos.
- Sistema Operativo: Cualquier distribución Linux (preferiblemente Ubuntu 24.04 LTS o Debian 13).
| Componente | Mínimo | Recomendado (AndroFan) |
|---|---|---|
| Motor DB | PostgreSQL 12 | PostgreSQL 16+ |
| Contenedor | Docker 24.x | Docker 27.x+ |
| Node.js | v18 | v20 (LTS) |
Despliegue con Docker Compose paso a paso
La forma más profesional y mantenible de instalar Wiki.js es mediante contenedores. Esto nos permite aislar las dependencias y facilitar las actualizaciones futuras sin romper el sistema operativo host.
1. Preparación del entorno
Primero, asegúrate de tener instalados Docker y el plugin de Compose. En 2026, la mayoría de distros ya incluyen estas versiones en sus repositorios oficiales.
- Crea un directorio dedicado:
mkdir wiki-js && cd wiki-js. - Crea el archivo de configuración:
nano docker-compose.yml. - Define los servicios de la base de datos y la aplicación.
2. Configuración del archivo YAML
Copia y pega este bloque de código optimizado para el rendimiento:
services:
db:
image: postgres:16-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: tu_password_segura
POSTGRES_USER: wiki
volumes:
- ./db-data:/var/lib/postgresql/data
wiki:
image: ghcr.io/requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wiki
DB_PASS: tu_password_segura
DB_NAME: wiki
ports:
- "80:3000"
restart: unless-stopped
Configuración inicial y seguridad avanzada
Una vez que ejecutes docker compose up -d, podrás acceder a través de la IP de tu servidor. La primera pantalla te pedirá un correo de administrador y la URL final de tu sitio.
Seguridad y Certificados SSL
En 2026, bajo ningún concepto debes exponer tu wiki sin HTTPS. Mi recomendación personal es usar Nginx Proxy Manager o Traefik como proxy inverso.
- Configura un certificado Let’s Encrypt gratuito.
- Habilita el HSTS para forzar conexiones seguras.
- Desactiva el registro público de usuarios si es una wiki personal.
Sincronización con Git y almacenamiento en la nube
Lo que hace que Wiki.js destaque sobre Notion o Obsidian es su capacidad de Backup bidireccional. Puedes vincular tu wiki con un repositorio de GitHub o GitLab.
Pasos para el almacenamiento externo
- Ve al panel de Storage en la administración.
- Selecciona el target Git.
- Genera una SSH Key en tu servidor y añádela a tu cuenta de GitHub.
- Configura el intervalo de sincronización (recomiendo 5 minutos).
Esto garantiza que, incluso si tu servidor explota, toda tu documentación está a salvo en formato .md (Markdown) puro, legible por cualquier otro software.
Ventajas y Desventajas
✅ Ventajas
- Interfaz moderna y Dark Mode nativo espectacular.
- Editor visual, Markdown y HTML en una sola herramienta.
- Buscador ultra rápido basado en Worker Threads.
- Multilingüe con soporte para más de 40 idiomas.
❌ Desventajas
- La versión 3.x sigue en desarrollo (la 2.x es la estable).
- Consumo de RAM superior a wikis estáticas como Hugo.
- Curva de aprendizaje ligera en la gestión de permisos.
Preguntas Frecuentes
¿Puedo migrar mis datos desde Notion?
Sí, puedes importar archivos Markdown masivamente, aunque perderás algunas bases de datos relacionales complejas propias de Notion.
¿Es Wiki.js gratuito para empresas?
Absolutamente. Tiene licencia AGPL-3.0, lo que permite su uso comercial y privado sin costes de licencia.
¿Qué pasa si mi base de datos se corrompe?
Si activaste la sincronización con Git, simplemente reinstala Wiki.js y vincula el repo; el sistema reconstruirá la base de datos automáticamente.
Conclusión
- Wiki.js es la herramienta definitiva para centralizar conocimiento técnico.
- El uso de Docker simplifica el despliegue y asegura la escalabilidad.
- La integración con Git es la mejor póliza de seguro para tus datos.
- Configura siempre un Proxy Inverso para garantizar la seguridad.
¿Estás pensando en montar tu propia base de conocimientos o prefieres seguir usando herramientas en la nube? ¡Cuéntanos tu experiencia en los comentarios!
