Lección 2 de 8 · 30 min
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.
Esto sí conviene mirarlo antes de empezar, porque no se instala en cualquier sitio:
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.
Admite varias, pero PostgreSQL es la recomendada y hay una razón de peso para elegirla - la de la nota de abajo.
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.
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.
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.
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.
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.
Esto se dice poco y evita perder un fin de semana montando algo que no necesitabas:
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.
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.
Una wiki guarda conocimiento, no seguimiento. Si lo que quieres es saber quién hace qué y para cuándo, necesitas otra cosa.
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 un servidor de verdad 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.
Pero para las lecciones siguientes conviene tener una wiki delante, y montar una en tu propio computador son cuatro pasos. No sale a internet, no sirve para tu empresa y se borra cuando quieras: es un banco de pruebas.
En docker.com, botón Download Docker Desktop (Windows). Ejecuta el instalador, acepta que active WSL 2 si lo pide y reinicia si te lo pide. Ábrelo una vez y espera a que abajo a la izquierda diga Engine running. Pide una cuenta gratuita: créala con tu correo. Docker es lo que te evita instalar Node.js y PostgreSQL a mano.
En el Explorador de archivos, entra en Este equipo → Disco local (C:) → Usuarios → tu nombre y crea ahí, si no existe, una carpeta cursos; dentro, otra llamada wiki. Inicio → Bloc de notas, pega el contenido del bloque de abajo, y Archivo → Guardar como: entra en esa carpeta, en Tipo elige Todos los archivos y en Nombre escribe docker-compose.yml (sin el .txt que el Bloc de notas añade si no eliges "Todos los archivos").
Inicio → cmd → Enter. Escribe cd %USERPROFILE%\cursos\wiki, Enter, y docker compose up -d, Enter. La primera vez descarga dos imágenes (unos minutos) y termina con dos líneas Started. Espera un minuto más y abre en el navegador http://localhost:3000.
Aparece Welcome to Wiki.js: escribe un correo de administrador (sirve administrador@demo.com), una contraseña que recuerdes, deja Site URL en http://localhost:3000 y pulsa Install. En medio minuto entras a la wiki vacía, con sesión iniciada. Botón + Create Page, editor Markdown, y ya estás en la lección 4. Para apagarla al terminar el día: en la ventana negra, docker compose down (sin -v, que borraría lo que escribiste).
services:
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_USER: wikijs
POSTGRES_PASSWORD: Demo2026Wiki
volumes:
- db-data:/var/lib/postgresql/data
restart: unless-stopped
wiki:
image: requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: Demo2026Wiki
DB_NAME: wiki
ports:
- "3000:3000"
restart: unless-stopped
volumes:
db-data:Son las dos piezas de la leccion: la base de datos (PostgreSQL, la recomendada) y Wiki.js, que ya trae Node.js dentro. La contrasena es la de esta practica; una wiki de verdad lleva la suya.
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