BookStack es un software Wiki de código abierto destinado a una plataforma sencilla, autoalojada y fácil de usar. Basado en Laravel, un framework PHP, BookStack está publicado bajo la licencia MIT. Utiliza las ideas de los libros para organizar páginas y almacenar información. BookStack está disponible en más de treinta idiomas. Por su sencillez, BookStack se considera adecuado para pequeñas empresas o autónomos.

BookStack se puede instalar de forma manual o bien desde Docker, además, disponen de unos scripts para poder hacer la instalación en Ubuntu 18.04 hasta Ubuntu 22.04.

En este tutorial, utilizaremos Ubuntu 22.04 para realizar la instalación, para ello necesitamos un dominio o subdominio, aunque se puede configurar el acceso vía IP.

Como siempre recomendamos revisar la Documentación Oficial de BookStrack para saber más de la configuración de esta aplicación.

Instalación de BookStrack

Nos conectaremos al servidor por SSH y nos descargaremos el script para realizar la instalación:

wget https://raw.githubusercontent.com/BookStackApp/devops/main/scripts/installation-ubuntu-22.04.sh
chmod a+x installation-ubuntu-22.04.sh

Y lo ejecutamos:

sudo ./installation-ubuntu-22.04.sh

Una vez ejecutado, nos pedirá si queremos configurar un nombre de dominio, subdominio o IP:

This script installs a new BookStack instance on a fresh Ubuntu 22.04 server.
This script does not ensure system security.

This script logs full output to /root/bookstack_install_1677493436.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 XX.XX.XXX.XXX.
midominio.com

Tras escribir el nombre de dominio, iniciará la instalación:

Installing using the domain or IP "midominio.com"

[1/9] Installing required system packages... (This may take several minutes)
[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...

Finalmente, al acabar la instalación nos dará el acceso vía web:

----------------------------------------------------------------
Setup finished, your BookStack instance should now be installed!
- Default login email: admin@admin.com
- Default login password: password
- Access URL: http://xx.xx.xx.xx/ or http://midominio.com/
- BookStack install path: /var/www/bookstack
- Install script log: /root/bookstack_install_1677505890.log
---------------------------------------------------------------

Configurar acceso SSL

Para configurar el acceso SSL, simplemente deberéis de crearlo con LEt's Ecnrypt siguiendo este otro 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.
📢
Ten en cuenta que en el .env de la aplicación está configurado con HTTP, por lo que deberás de editar /var/www/bookstack/.env para modificar el parámetro APP_URL y añadir HTTPS.
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