Cómo configurar Wiki.js y tener tu propia wiki en minutos

Wiki.js es una poderosa plataforma de wiki de código abierto construida sobre Node.js. Soporta edición tanto en Markdown como WYSIWYG, colaboración en tiempo real, control de versiones y opciones de autenticación flexibles, incluyendo Google y LDAP. En esta guía, te mostramos cómo configurar Wiki.js con Docker para que puedas tener tu wiki funcionando en solo unos minutos.

Instala Wiki.js usando Docker Compose

Usando Docker y Docker Compose, es increíblemente fácil configurar wiki.js. Primero, crea un directorio llamado “wikijs-docker” y accede a él usando el comando cd:

mkdir wikijs-docker &&cd wikijs-docker

Después de esto, crea un archivo “docker-compose.yml” en cualquier editor de texto:

nano docker-compose.yml

Y luego, pega el siguiente contenido en este archivo:

services:  
  
  db:  
    image: postgres:16  
    environment:  
      POSTGRES_DB: wiki  
      POSTGRES_PASSWORD: wikijsrocks  
      POSTGRES_USER: wikijs  
    restart: unless-stopped  
    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: wikijs  
      DB_PASS: wikijsrocks  
      DB_NAME: wiki  
    restart: unless-stopped  
    ports:  
      - "80:3000"  
  
volumes:  
  db-data:

Guarda y cierra el archivo, y luego inicia los contenedores usando el siguiente comando:

docker compose up -d

Una vez que la configuración haya terminado, abre wiki.js en tu navegador en http://localhost. Especifica los detalles de la cuenta de administrador y haz clic en el botón Instalar para comenzar la instalación:

Después de la instalación, introduce tus credenciales para iniciar sesión.

Crear y administrar páginas en Wiki.js

Ahora puedes crear la página de inicio para comenzar a agregar contenido o acceder al panel de administración para gestionar configuraciones, usuarios y funciones:

Si haces clic en el botón Crear Página de Inicio, se te pedirá que selecciones un editor para la página. Selecciona el que prefieras según tus necesidades:

Especifica las propiedades de la página y haz clic en el botón OK para crear una nueva página:

Escribe lo que desees y haz clic en el botón Crear para crear la página:

Administrar y organizar contenido

En el tablero, puedes ver y editar páginas existentes, crear nuevas páginas usando tu editor preferido y organizar tu contenido moviendo, renombrando o eliminando páginas. También puedes agregar etiquetas para categorizar el contenido de manera efectiva. Además, la barra lateral y la barra de búsqueda facilitan la navegación rápida a páginas específicas dentro de tu wiki:

Configuración del sitio Wiki.js

En el panel de administración de Wiki.js, puedes configurar la configuración del sitio, como la localización, navegación, temas y etiquetas. Estas opciones ayudan a definir la configuración global de tu instancia de Wiki.js.

Puedes configurar la configuración básica en el tab General, como el título del sitio, descripción, página de inicio predeterminada y visibilidad del sitio (público o privado):

Navega al tab Localización para establecer el idioma predeterminado, la zona horaria y los formatos de fecha/hora utilizados en todo el sitio:

Para gestionar la estructura de los menús de tu wiki y controlar cómo los usuarios navegan por el contenido, ve a la Barra de Navegación.

En el tab Páginas, puedes ver, gestionar y organizar todas las páginas del wiki. Puedes crear nuevas páginas, editar las existentes o gestionar la jerarquía de las páginas.

También puedes crear y gestionar etiquetas de contenido en el tab Etiquetas para ayudar a categorizar las páginas y mejorar la búsqueda. Del mismo modo, puedes modificar la apariencia y el estilo de tu wiki desde el tab Tema. Por ejemplo, puedes modificar el logo del sitio, colores, fuentes y temas de diseño.

Administrar grupos en tu wiki

En la sección Grupos, puedes crear grupos de usuarios, asignar miembros y establecer permisos a nivel de grupo para controlar el acceso. Utiliza los grupos para organizar a los usuarios por rol y gestionar su acceso de manera consistente a través de tu wiki.

Puedes hacer clic en un grupo particular para actualizar su configuración, permisos, reglas de página y gestionar los usuarios dentro de ese grupo. El tab Configuraciones te permite configurar opciones como la URL de redirección al iniciar sesión.

Además, puedes navegar a través de los tabs Permisos, Reglas de Página y Usuarios para controlar a qué puede acceder el grupo y qué usuarios están asignados a él.

Gestión de usuarios en Wiki.js

Para crear un nuevo usuario, ve a la sección Usuarios, haz clic en el botón NUEVO USUARIO y especifica los detalles requeridos.

Después de esto, haz clic en el botón CREAR o CREAR Y CERRAR para crear un nuevo usuario:

Haz clic en un usuario específico para ver y editar su perfil, asignarlos a grupos de usuarios, establecer métodos de autenticación como contraseñas y autenticación de dos factores, y gestionar su estado usando acciones como Desactivar, Verificar o Eliminar:

También puedes actualizar su información básica, metadatos extendidos (como ubicación y título laboral) y monitorear su historial de actividad:

Gestionar tus módulos de wiki

Los módulos son funciones opcionales que mejoran la funcionalidad de Wiki.js. Por ejemplo, el módulo Analíticas permite habilitar y configurar integraciones como Google Analytics para rastrear el comportamiento del usuario y el tráfico en tu wiki.

Utiliza el tab Autenticación para configurar y gestionar proveedores de autenticación (como inicio de sesión local, LDAP, OAuth) y configurar opciones de inicio de sesión.

Puedes habilitar o deshabilitar el sistema de comentarios y elegir cómo los usuarios interactúan con las discusiones de las páginas.

Configuración del sistema

También puedes gestionar cómo se renderiza, busca y almacena el contenido configurando motores de renderizado, indexación de búsqueda y opciones de almacenamiento. Por ejemplo, puedes navegar al tab Renderizado para personalizar cómo se renderiza el contenido, como la configuración del motor de Markdown o el soporte para diagramas, expresiones matemáticas, etc.

En la sección Motor de Búsqueda, puedes configurar opciones de indexación de búsqueda interna e integraciones con motores de búsqueda:

Ve a la sección Almacenamiento para establecer objetivos de respaldo y sincronización para tu contenido. Aquí puedes administrar dónde y cómo se almacenan los medios y los archivos adjuntos en las páginas (sistema de archivos local, AWS S3, etc.):

Gestionar seguridad y conectividad

Puedes gestionar la seguridad y conectividad configurando el acceso a la API, estableciendo el correo electrónico para notificaciones, ajustando políticas de seguridad y habilitando SSL para asegurar tu sitio Wiki.js. Por ejemplo, puedes gestionar tokens de API para integrar Wiki.js con sistemas externos o tus propias aplicaciones personalizadas:

Podemos configurar los ajustes de correo electrónico saliente para manejar notificaciones, invitaciones y recuperación de contraseñas en Wiki.js.

Puedes configurar ajustes de Seguridad como tiempos de espera de sesión, políticas de contraseña y restricciones de acceso.

Además de esto, puedes configurar certificados SSL/TLS para asegurar tu sitio Wiki.js con HTTPS.

Aparte de esto, puedes confirmar la información de tu Wiki, como ver diagnósticos del sistema, detalles del servidor y estadísticas del entorno de ejecución, desde la sección Información del Sistema.

Puedes realizar acciones de mantenimiento como reindexar la búsqueda, limpiar cachés o restablecer configuraciones desde el tab Utilidades.

Finalmente, las Herramientas para Desarrolladores te permiten acceder a herramientas avanzadas como el playground de GraphQL, registros de depuración o scripts personalizados:

Ahora que has aprendido cómo configurar Wiki.js con Docker, puedes usarlo para construir documentación interna, wikis de equipo o incluso bases de conocimiento públicas con facilidad. Si aún estás considerando tus opciones, consulta nuestra comparación entre DokuWiki y Wiki.js para ver qué plataforma es la adecuada para tu proyecto.