La base de datos
Lo imprescindible. Todo el contenido está aquí. Un volcado periódico y automático, guardado en otro sitio.
Lo que hay que respaldar de verdad
Aquí está el error técnico que más caro sale, y es fácil de cometer: se respalda la carpeta donde está instalada la aplicación y se da el trabajo por hecho.
El contenido de tu wiki no está en esa carpeta. Las páginas, los usuarios, los permisos y el historial completo viven en la base de datos. Sin ella, tienes el programa y ni una sola página.
Los archivos subidos
Imágenes y documentos adjuntos. Según la configuración pueden estar en disco y no en la base: compruébalo, no lo supongas.
La configuración
El archivo de configuración con los datos de conexión. Pequeño y fácil de olvidar, y sin él hay que reconstruir la instalación a ciegas.
🔴 Un respaldo que nadie ha restaurado no es un respaldo. Es la regla que más se incumple en informática. Prueba a restaurarlo en otro sitio antes de necesitarlo: es la única forma de saber si el archivo sirve, si está completo y si sabes hacerlo.
Descubrir que el volcado estaba vacío el día que se cae el servidor es una experiencia que conviene ahorrarse.
Y una ventaja de Wiki.js que conviene aprovechar
Wiki.js puede sincronizar el contenido con almacenamiento externo, incluido un repositorio de código. Es decir: además de la base de datos, tus páginas pueden quedar como archivos de texto en otro sitio.
Eso da una red de seguridad excelente: aunque la instalación se pierda entera, el contenido - que es lo que costó escribir - sigue existiendo en forma legible.
Actualizar sin romper nada
Wiki.js publica versiones nuevas con correcciones de seguridad. No actualizar deja una aplicación web expuesta con fallos conocidos, y eso sí es un riesgo real.
1. Respalda antes. Siempre.
Base de datos y archivos. No es paranoia: una actualización que falla a mitad puede dejar la base en un estado intermedio.
2. Lee qué cambia en esa versión
Las notas de la versión avisan si hay algo que requiere atención, como un cambio en los requisitos.
3. Actualiza en un momento tranquilo
No un viernes por la tarde ni el día que todo el equipo está consultando la wiki.
4. Comprueba después
Que entra, que se ven las páginas, que la búsqueda funciona y que se puede editar. Cuatro comprobaciones de un minuto.
Recuerda lo de la lección 2: si montaste sobre MySQL, MariaDB, SQL Server o SQLite, la próxima versión mayor no los admitirá. Esa actualización será una migración, no un cambio de versión - conviene planificarla y no descubrirla el día que toque.
Proyecto final
Monta tu primera wiki de verdad. Y para llenarla de contenido útil desde el primer día, hay un tema que ya conoces bien: lo que aprendiste en los otros cursos.
1. Elige dónde va a vivir (lección 2)
Un servidor con Node.js 22 o 24 y PostgreSQL, por lo que ya sabes. Si es para practicar, tu propio computador sirve.
2. Crea tres secciones, no quince (lección 3)
Por tarea, no por área. Y la página «Empezar aquí».
3. Escribe tres páginas de verdad (lección 4)
Por ejemplo: un procedimiento que hoy solo sepas tú, una lista de comprobación que uses a menudo, y una página de «errores frecuentes y su solución».
Con su para qué sirve, sus pasos numerados y su cómo saber que salió bien.
4. Define dos grupos (lección 5)
Todos con permiso de escritura, y administradores. Sin contraseñas dentro de ninguna página.
5. Comprueba que se encuentra (lección 6)
Busca tus páginas con las palabras que usaría otra persona, no con las tuyas. Si no aparecen, ajusta los títulos.
6. Pásale la prueba de fuego (lección 4)
Dale un procedimiento a alguien que no sepa hacerlo, y no le ayudes. Cada pregunta que te haga es un paso que falta.
7. Programa el respaldo (esta lección)
De la base de datos, automático, guardado en otro sitio. Y restaura una copia para comprobar que funciona.
8. Ponle dueño a cada sección (lección 7)
Con nombre. Es lo que decide si la wiki sigue viva dentro de un año.
Lo que te llevas
Sabes por qué documentar, cómo estructurar para que se encuentre, cómo escribir un procedimiento que otro pueda seguir, cómo repartir permisos sin matar la participación, y qué hace falta para que la wiki siga viva.
Y sabes lo que ningún tutorial cuenta: que el problema de la documentación nunca fue técnico. Montar la herramienta es la tarde más fácil del proyecto.
Con este cierras los cinco cursos básicos. Cada uno resuelve una parte - organizar datos, analizarlos, automatizar, usar la IA con criterio y escribir lo que se sabe -, y todos comparten la misma idea: la herramienta es lo de menos si no entiendes qué problema estás resolviendo.
Compruébalo tú mismo
Respaldas cada noche la carpeta donde está instalado Wiki.js. Se cae el servidor. ¿Qué tienes?
Las páginas, los usuarios, los permisos y el historial viven en
la base de datos. Respaldar solo la carpeta de la aplicación deja un programa
perfectamente instalado y vacío. Es el error más caro de esta lección.
¿Cuándo sabes que tu respaldo sirve?
Un proceso sin errores puede generar un archivo inútil, y un
tamaño razonable no garantiza que el contenido esté completo. La única prueba
real es restaurarlo - y hacerlo antes de necesitarlo.
Terminaste Documentación con Wiki.js. Presenta la evaluación y reclama tu certificado.
Quiero mi certificado ← Mantenerla viva: el problema que mata las wikis