Documentación con Wiki.js

Qué es Wiki.js: requisitos, licencia y alternativas

Lección 2 de 8 · 16 min

Una wiki que se instala en tu servidor

Wiki.js es un programa que instalas en un servidor y que te da una wiki: páginas que se escriben y se editan desde el navegador, con búsqueda, historial y control de quién puede ver qué.

La diferencia con un servicio en la nube es que los datos se quedan donde tú digas. La contrapartida es que el mantenimiento es tuyo.

Qué hace falta para montarlo

Esto sí conviene mirarlo antes de empezar, porque no se instala en cualquier sitio:

Un servidor con Node.js

Wiki.js corre sobre Node.js 22 o 24. Las versiones impares - 21, 23 - no están soportadas oficialmente.

⚠️ Un hosting compartido normal, de los de páginas web, casi nunca tiene Node.js. Suele hacer falta un servidor propio o alquilado.

Una base de datos

Admite varias, pero PostgreSQL es la recomendada y hay una razón de peso para elegirla - la de la nota de abajo.

Poco espacio y poca memoria

Al menos 1 GB de RAM en Linux y 1 GB de almacenamiento. Es de las aplicaciones más ligeras de su tipo.

⚠️ Elige PostgreSQL, aunque tengas MySQL a mano. Wiki.js admite hoy MySQL, MariaDB, SQL Server y SQLite, pero su propia documentación avisa de que esos motores NO serán compatibles en la próxima versión mayor.

Quien monte hoy sobre MySQL va a tener que migrar la base entera cuando quiera actualizar. Elegir PostgreSQL desde el principio es cinco minutos de decisión que ahorran un fin de semana de trabajo.

La licencia: aquí sí es software libre

Wiki.js se publica bajo la licencia AGPL versión 3. Es software libre en el sentido estricto: puedes usarlo, modificarlo y distribuirlo, incluso comercialmente.

Pero la AGPL tiene una condición que conviene conocer, porque es lo que la distingue de otras licencias libres.

Lo que puedes hacer sin pensarlo

Instalarlo para tu equipo, tu empresa o tu proyecto. Usarlo gratis, para siempre, sin límite de usuarios ni de páginas. Modificarlo para tus necesidades.

Es el caso del 99% de quien hace este curso.

La condición de la AGPL

Si modificas Wiki.js y ofreces esa versión modificada como servicio a otros a través de la red, tienes que poner tus cambios a disposición de esos usuarios.

La AGPL existe justamente para eso: para que las mejoras vuelvan a la comunidad en vez de quedarse en un servicio cerrado.

La diferencia con la licencia de n8n

Si vienes del curso de n8n, fíjate en el contraste: aquella prohíbe ofrecerlo como servicio comercial. La AGPL no lo prohíbe - solo exige compartir tus modificaciones si lo haces.

Dos licencias muy distintas, y por eso no se pueden dar por sabidas.

Cuándo Wiki.js NO es la herramienta

Esto se dice poco y evita perder un fin de semana montando algo que no necesitabas:

  1. Si sois dos personas y diez páginas

    Un documento compartido en la nube te resuelve el problema hoy, sin servidor ni mantenimiento. Monta una wiki cuando el documento se te quede corto, no antes.

  2. Si nadie va a mantener el servidor

    Una instalación propia hay que actualizarla y respaldarla. Si no hay nadie que se ocupe, en un año tendrás una wiki desactualizada y sin copias - y con datos dentro.

  3. Si lo que necesitas es un gestor de tareas

    Una wiki guarda conocimiento, no seguimiento. Si lo que quieres es saber quién hace qué y para cuándo, necesitas otra cosa.

  4. Si el contenido es público y quieres posicionarlo

    Para documentación de cara al público hay herramientas orientadas a eso. Wiki.js brilla en lo interno: cuando hay que controlar quién ve qué.

La instalación en sí no la vamos a cubrir paso a paso: depende demasiado de tu servidor y la documentación oficial la explica mejor y más actualizada de lo que podría un curso. Lo que sí vas a aprender es todo lo que viene después de instalar, que es donde se decide si la wiki sirve o se abandona.

Compruébalo tú mismo

Tienes MySQL instalado y funcionando. ¿Lo usas para Wiki.js?

Quieres instalar Wiki.js para tu empresa y usarlo internamente. ¿Qué te exige la licencia AGPL?

Siguiente: La estructura: que la información se encuentre

Continuar ← El conocimiento que vive en una sola cabeza