Skip to main content

Instalación de la web

Para la instalación del sistema de Bookstack se ha hecho uso del manual oficial de la web de Bookstack.

Desde una terminal con permisos de administrador, instale los requisitos

sudo apt install composer php8.2 libapache2-mod-php8.2 php8.2-common php8.2-sqlite3 php8.2-curl php8.2-intl php8.2-mbstring php8.2-xmlrpc php8.2-mysql php8.2-gd php8.2-xml php8.2-cli php8.2-tidy php8.2-zip php8.2-fpm unzip wget git 

Desde un usuario sin permisos de root se ha de clonar el repositorio de la aplicación

mkdir bstack 
cd bstack
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch
cd BookStack
composer install --no-dev
cp .env.example .env

Dentro del fichero ha de modificar los valores de los parametros

DB_HOST=localhost
DB_DATABASE=bookstackdb        
DB_USERNAME=bookstackuser
DB_PASSWORD=password_seteada_en_la_db

Configure el servidor smtp

MAIL_DRIVER=smtp
MAIL_FROM_NAME="Documentacion"
MAIL_FROM=mi_cuenta_correo@dominio.com
MAIL_HOST=IP_DEL_RELAY_MAILER
MAIL_PORT=25
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

Configure la URL en la que quiere que Bookstack funcione, si quiere alojarla en un subdominio llamado documentación

APP_URL=http://documentacion.dominio.com

Configure el idioma por defecto del bookstack (para los usuarios que realizan login por primera vez o los invitados).

APP_LANG=es_ES

En el servidor web cree la carpeta para el virtual host.

mkdir -p /var/www/vhosts/bookstack/

Mueva el contenido de la carpeta de git descargada a la carpeta de virtual

mv * /var/www/vhosts/bookstack/
chown www-data:www-data /var/www/vhosts/bookstack -R

Es momento de generar la clave de la aplicación. El comando indicado informará de que se va a generar una clave, acepte los cambios.

php artisan key:generate
php artisan migrate

Si ejecuta el comando cat .env podrá ver la clave que ha generado para la aplicación.