BookStack - Instalação em Ubuntu 22.04

Plataforma

A Bookstack é para mim a plataforma de eleição na criação de repositórios de conhecimento.

Sistema Operativo

Neste guia a implementação da BookStack é feita em cima de Ubuntu 22.04.

Instalação

Depois do Ubuntu Server 22.04 instalado, atualizado e seguro, descarregamos o script abaixo:

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

Tornamos o mesmo executável:

chmod a+x installation-ubuntu-22.04.sh

Executamo-lo com permissões de administrador.
Notas:
Este script só deve ser corrido numa nova instalação de Ubuntu 22.04;
Se o website será afeto, por exemplo, ao domínio "repositorio.pt", escrever isso quando surge a pergunta "Enter the domain (or IP...)"

sudo ./installation-ubuntu-22.04.sh

A instalação fica alojada em:

/var/www/bookstack

SSL

Para fazer a instalação de certificado, podemos usar CertBot e LetsEncrypt:

https://certbot.eff.org/instructions?ws=apache&os=ubuntufocal

Para forçar redirect da 80 para a 443:

https://docs.sam.gy/books/bookstack/page/enabling-https-for-the-bookstack-web-interface

Autenticação LDAP

Neste link encontram informação para implementação de autenticação LDAP.

Executem o comando seguinte para abrirem o ficheiro .env:

 

sudo nano /var/www/bookstack/.env

De qualquer forma, como tive de fazer alguma personalização para o meu ambiente, deixo abaixo valores para que tenham referência (LDAP pela 389, e-mail sem autenticação, qual o campo de utilizador referenciado, campo da foto, etc):

 

Atualização / Manutenção

Neste link temos as instruções sobre como atualizar a plataforma.

De qualquer forma, os comandos abaixo são os que devem ser corridos:

sudo apt -y update && sudo apt -y upgrade
cd /var/www/bookstack
sudo git pull origin release
composer install --no-dev
php artisan migrate
sudo php artisan cache:clear
sudo php artisan config:clear
sudo php artisan view:clear
sudo systemctl restart apache2

E está feito.

Notas Importantes:

Se o processo de registo e login entrar em loop, eliminar o ficheiro abaixo e reiniciar o servidor:

/var/www/bookstack/bootstrap/cache/routes-v7.php

Doação

Se o acima te trouxe valor, aceito com gratidão uma doação