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 php7.4php8.2 libapache2-mod-php7.4php8.2 php7.4-php8.2-common php7.4-php8.2-sqlite3 php7.4-php8.2-curl php7.4-php8.2-intl php7.4-php8.2-mbstring php7.4-php8.2-xmlrpc php7.4-php8.2-mysql php7.4-php8.2-gd php7.4-php8.2-xml php7.4-php8.2-cli php7.4-php8.2-tidy php7.4-php8.2-zip 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.