Tutoriales Aplicaciones Web / diciembre 17, 2024

Instalación de BookStack en Ubuntu 24.04

No estás usando esta distribución?

Selecciona una versión o distribución diferente

En esta guía, aprenderemos a instalar BookStack, una herramienta de documentación colaborativa basada en la web que permite organizar, gestionar y compartir información de manera eficiente. Diseñada con un enfoque sencillo y flexible, BookStack es una solución ideal para equipos, empresas o usuarios individuales que buscan centralizar su documentación en una interfaz limpia y moderna.

BookStack es un software de código abierto escrito en PHP y respaldado por una base de datos como MySQL o MariaDB. Su diseño intuitivo está inspirado en una estructura jerárquica de libros, capítulos y páginas, lo que facilita a los usuarios organizar contenido de forma lógica y accesible. Entre sus características principales se incluyen:

  • Editor WYSIWYG integrado: para crear y editar contenido fácilmente, sin necesidad de conocimientos técnicos.
  • Control de permisos: permite gestionar el acceso y las acciones de los usuarios.
  • Búsqueda avanzada: encuentra contenido rápidamente mediante palabras clave.
  • Temas personalizables: adapta el diseño a las necesidades de tu organización.
  • Integraciones y API: para conectarlo con otros servicios y automatizar flujos de trabajo.

Instalación de Bookstack

Lo primero de todo, después de tener un servidor con Ubuntu 24.04, será actualizar repositorios y paquetes:

apt update
apt upgrade

Para la instalación de Bookstack, la realizaremos utilizando el script que nos proporcionan por lo que la instalación será muy sencilla. Ejecutamos el script:

wget https://codeberg.org/bookstack/devops/raw/branch/main/scripts/installation-ubuntu-24.04.sh

Luego cambiamos permisos para que sea ejecutable y lo ejecutamos:

chmod a+x installation-ubuntu-24.04.sh
./installation-ubuntu-24.04.sh

Una vez inicie el script, nos pedirá información adicional para completar el script. Lo primero que nos preguntará es el dominio para el sitio.

💡
Si queremos tenerlo en local, podemos hacerlo, ya que permite configurar directamente la IP. Ahora bien, si necesitamos configurar un certificado SSL, deberemos de poner un dominio.
This script installs a new BookStack instance on a fresh Ubuntu 24.04 server.
This script does not ensure system security.

This script logs full output to /root/bookstack_install_1730754449.log which may help upon issues.

Enter the domain (or IP if not using a domain) you want to host BookStack on and press [ENTER].
Examples: my-site.com or docs.my-site.com or 85.208.XX.XX
midominio.com

Installing using the domain or IP "midominio.com"

[1/9] Installing required system packages... (This may take several minutes)

Tras poner el domino, iniciará la instalación de todo:

[2/9] Preparing MySQL database...
[3/9] Downloading BookStack to /var/www/bookstack...
[4/9] Installing Composer (PHP dependency manager)...
[5/9] Installing PHP dependencies using composer...
[6/9] Creating and populating BookStack .env file...
[7/9] Running initial BookStack database migrations...
[8/9] Setting BookStack file & folder permissions...
[9/9] Configuring apache server...
----------------------------------------------------------------
Setup finished, your BookStack instance should now be installed!
- Default login email: admin@admin.com
- Default login password: password
- Access URL: http://85.208.XX.XXX/ or http://dominio.com/
- BookStack install path: /var/www/bookstack
- Install script log: /root/bookstack_install_1730754449.log
---------------------------------------------------------------

Configuración con SSL

Para añadir el SSL deberemos de instalar los paquetes necesarios y utilizar la configuración para Apache del siguiente tutorial:

Cómo utilizar Certbot para configurar un SSL de Let’s Encrypt en GNU/Linux
Certbot es una maravillosa herramienta que puedes utilizar para generar un certificado SSL con Let’s Encrypt e instalarlo y configurar automáticamente en tu servidor web.
_ voidNullDon T3rr0rZ0n3

Luego para que cargue correctamente por HTTPS, es necesario editar el fichero de configuración de Bookstack. Este fichero se encuentra en /var/www/bookstack/.env.

En este fichero tenemos que buscar el parámetro APP_URL y añadir HTTPS:

APP_URL=https://midominio.com

Guarda el fichero, y ya deberías de poder acceder por HTTPS sin problemas.

Más sobre ./voidNull

Haz que cada palabra cuente: tu donación nos inspira a seguir creando contenido. Accede al apartado de Donación para hacer tu aportación