Skip to main content

Paso 3: Instalación de BookStack

Primer arranque

En el primer arranque de Ubuntu Server desde la Raspberry Pi, se ejecuta una herramienta llamada cloud-init. En mi caso, tardó aproximadamente 10 minutos en finalizar. Como se indica en la guía, es importante que finalice este proceso.

Si se interrumpe el proceso, habrá que empezar de nuevo. Sabremos que ha acabado cuando aparecen unas pocas líneas justo después del login prompt.

Para la configuración inicial de Ubuntu Server, conecté la Raspberry Pi directamente a la red de casa para que pudiera obtener una IP por DHCP (la Raspberry Pi tiene únicamente atachados el cable de alimentación y el cable de red directamente al home router).

En la página de configuración del home router veo en los leases DHCP la IP asignada a la Raspberry. Para la gestión de ahora en adelante de la Raspberry, hago SSH a dicha IP (aprovechando la configuración de SSH en el paso 2).

image.png
Instalación de BookStack

Para la instalación de BookStack sigo los pasos indicados en la guía de instalación, concretamente en el apartado que es específico para el servidor que he instalado (Ubuntu 22.04 Installation Script). 

La instalación con este método es automatizada. Simplemente se descarga un script, se le da permisos de ejecución y se ejecuta, instalando los componentes necesarios que se describen en la guía como requisitos.

# Ensure you have read the above information about what this script does before executing these commands.

# Download the script
wget https://raw.githubusercontent.com/BookStackApp/devops/main/scripts/installation-ubuntu-22.04.sh

# Make it executable
chmod a+x installation-ubuntu-22.04.sh

# Run the script with admin permissions
sudo ./installation-ubuntu-22.04.sh

Como se indica en el primer comentario del bloque de código, se recomienda repasar (por encima) el script para ver que es lo que hace. El script está disponible en GitHub (link).

A grandes rasgos, se describe de la siguiente manera:

A script to install BookStack on a fresh instance of Ubuntu 22.04 is available. This script is ONLY FOR A FRESH OS, it will install Apache, MySQL 8.0 & PHP-8.1 and could OVERWRITE any existing web setup on the machine. It also does not set up mail settings or configure system security so you will have to do those separately. You can use the script as a reference if you’re installing on a non-fresh machine.

Para acceder a MySQL, puede hacerse por defecto sin contraseña desde el usuario root (mysql -u root)

En el script hay un único prompt, que es para introducir la IP o el dominio donde se alojará BookStack. Vídeo guía:

Una vez instalado se puede acceder en local desde la IP de la Raspberry Pi (puerto 80/HTTP).


Back to top