BookStack es una plataforma de documentación y wiki de código abierto que organiza el contenido en una estructura jerárquica intuitiva: Libros → Capítulos → Páginas.

Características Principales

📚 Organización Jerárquica: Libros, capítulos y páginas
✏️ Editor Dual: WYSIWYG y Markdown
🔍 Búsqueda Potente: Indexación completa del contenido
🔐 Control de Acceso: Permisos granulares por rol
📝 Historial de Cambios: Seguimiento completo de ediciones
🖼️ Gestión de Imágenes: Biblioteca de medios integrada
🔗 Integración: LDAP, SAML 2.0, OAuth (Google, GitHub, etc.)
🌍 Multi-idioma: Soporte para múltiples idiomas incluido español

Casos de Uso

Documentación técnica: Manuales, guías, procedimientos
Base de conocimiento: Wiki corporativa, FAQ
Documentación de proyectos: Desarrollo de software
Políticas y procedimientos: Compliance, ISO, GDPR
Notas colaborativas: Equipos distribuidos

Inicio Rápido

Requisitos

Docker Engine
Portainer (recomendado)
Red proxy creada
MariaDB 12 (incluido en el compose)

Generar Claves y Contraseñas

ANTES de desplegar, genera las claves necesarias:

# APP_KEY (BookStack)
docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

# DB_PASSWORD (MariaDB)
openssl rand -base64 32

⚠️ Importante: Si la contraseña contiene caracteres especiales ($, !, etc.), usa comillas simples en el .env:
DB_PASSWORD='tu_password_con_$_especiales'

Despliegue Básico

Crea el stack en Portainer con Git Repository:
- URL: https://git.ictiberia.com/groales/bookstack
- Compose path: docker-compose.yml

Añade variables de entorno:

APP_KEY=base64:tu_clave_generada
DB_PASSWORD=password_generado
DOMAIN_HOST=bookstack.tudominio.com

Deploy y espera 1-2 minutos (BookStack inicializa la BD)
Accede y configura según tu proxy inverso:
- Traefik: https://bookstack.tudominio.com
- NPM: Configura Proxy Host primero
- Login: Email admin@admin.com + password password ¡CÁMBIALO INMEDIATAMENTE!

Arquitectura

┌─────────────────────────────────────────────────┐
│          Traefik / NPM (Proxy)                  │
│              HTTPS / SSL                        │
└────────────────┬────────────────────────────────┘
                 │
       ┌─────────▼──────────┐
       │     BookStack      │  Puerto 80
       │  (LinuxServer)     │
       └─────────┬──────────┘
                 │
           ┌─────▼──────┐
           │  MariaDB   │
           │     11     │
           └────────────┘
          (Base Datos)

Componentes

BookStack: Aplicación PHP Laravel (puerto 80)
MariaDB 12: Base de datos MySQL
Proxy: Traefik o NPM para HTTPS

Volúmenes

bookstack_config: Configuración, uploads, imágenes
bookstack_db: Base de datos MariaDB

Próximos Pasos

Elige tu modo de despliegue:
- Traefik - Recomendado para múltiples servicios
- NPM - Más simple para configurar
Configura BookStack:
- Configuración Inicial - Primer acceso
- Personalización - LDAP, temas, etc.
Protege tus datos:
- Backup y Restauración - Automatiza backups
Mantén actualizado:
- Actualización - BookStack y MariaDB

BookStack Wiki

📑 Índice

Inicio Rápido

Modos de Despliegue

Configuración y Uso

¿Qué es BookStack?

Características Principales

Casos de Uso

Inicio Rápido

Requisitos

Generar Claves y Contraseñas

Despliegue Básico

Arquitectura

Componentes

Volúmenes

Próximos Pasos

Recursos Oficiales

BookStack Wiki

🚀 Inicio

📦 Despliegue

⚙️ Configuración

💾 Mantenimiento