Por qué autoalojar BookStack en un VPS
BookStack destaca por su simplicidad: allí donde otros wikis ahogan al usuario con opciones, él impone una jerarquía clara en estantes, libros, capítulos y páginas, lo que hace la documentación navegable de inmediato. Construido sobre el framework Laravel, es ligero y fácil de mantener. Autoalojado en un VPS, conserva toda su documentación interna —procedimientos, runbooks, base de conocimiento de clientes— en su propia infraestructura, sin suscripción por usuario. Para una agencia que documenta sus proyectos o un equipo técnico que centraliza sus procedimientos, es un wiki privado que usted controla de principio a fin, con búsqueda de texto completo, gestión detallada de permisos y editor WYSIWYG o Markdown.
Beneficios concretos de un BookStack autoalojado
- Estructura clara en estantes/libros/capítulos/páginas: documentación navegable sin esfuerzo.
- Editor WYSIWYG y Markdown a elección, con diagramas Draw.io integrados.
- Permisos granulares por rol y por libro para compartimentar los contenidos sensibles.
- Búsqueda de texto completo y rápida sobre el conjunto de la base de conocimiento.
- Autenticación LDAP, SAML u OAuth para integrarse con su directorio corporativo.
- Huella ligera: un VPS modesto basta para la documentación de un equipo.
Requisitos de hardware y software
BookStack es poco exigente. Un VPS de 1 a 2 vCPU y 2 GB de RAM aloja cómodamente la documentación de un equipo; el consumo sube sobre todo con el volumen de imágenes subidas. Se apoya en MySQL o MariaDB. Prevea de 15 a 25 GB de SSD según la cantidad de archivos adjuntos. En cuanto al software: Docker y Docker Compose, un subdominio wiki.sudominio.com con registro A, y un servidor SMTP para el envío de invitaciones y notificaciones por correo electrónico.
Desplegar BookStack con Docker y SSL
Preparar el VPS
Instale Docker y el plugin Compose, y después cree
/opt/bookstack. La imagen comunitarialscr.io/linuxserver/bookstackes la más extendida y la mejor mantenida para un despliegue en contenedores.Declarar MySQL y BookStack
En el
docker-compose.yml, añada un serviciomariadbcon una base de datos y un usuario dedicados, más el serviciobookstack. Rellene la variableAPP_URLcomohttps://wiki.sudominio.com: una URL incorrecta rompe los enlaces internos y las subidas de archivos.Lanzar la pila
Ejecute
docker compose up -dy luego vigiledocker compose logs -f bookstack. En el primer arranque, BookStack ejecuta automáticamente las migraciones de Laravel para crear el esquema de la base de datos.Configurar el reverse proxy y el SSL
Con Caddy:
wiki.sudominio.com { reverse_proxy localhost:6875 }, el certificado se gestiona solo. Con Nginx, redirija hacia127.0.0.1:6875y obtenga el certificado concertbot --nginx.Primera conexión y SMTP
Inicie sesión con la cuenta por defecto
[email protected]y cambie inmediatamente la contraseña. Configure las variables SMTP (MAIL_HOST,MAIL_USERNAME...) para activar las invitaciones de usuarios y el restablecimiento de contraseña.
Cuide su estrategia de copias de seguridad: una instancia de BookStack se restaura a partir de tres elementos: el dump de la base de datos MySQL/MariaDB, la carpeta uploads (imágenes y archivos adjuntos) y el archivo de configuración que contiene la clave APP_KEY. Sin esa clave de aplicación de Laravel, los contenidos cifrados no podrán descifrarse tras la restauración. Automatice un mysqldump diario más una copia del volumen uploads hacia un almacenamiento externo, y guarde con especial cuidado la APP_KEY fuera del servidor.
