====== Bookstack ======
<WRAP center round important 60%>
Ébauche 
</WRAP>

<WRAP center round alert 60%>
Ne pas prendre cette procédure pour exemple. Elle m'a servie dans un environnement de test, pas en prod !
</WRAP>


===== Pré-requis =====

Installer les paquets nécéssaires
<code bash>
apt install -y apache2 php php-{gd,mbstring,tokenizer,xml,curl,mysql} libapache2-mod-php mariadb-server mariadb-client git unzip
</code>

===== Activer les services =====
Activer les services
<code bash>
systemctl enable apache2
a2enmod "php*" rewrite
sysemctl restart apache2
</code>

===== Paramétrer Mariadb =====
Configurer MariaDB : 
<code bash>
mysql_secure_installation

NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!

In order to log into MariaDB to secure it, we'll need the current
password for the root user. If you've just installed MariaDB, and
haven't set the root password yet, you should just press enter here.

Enter current password for root (enter for none):
OK, successfully used password, moving on...

Setting the root password or using the unix_socket ensures that nobody
can log into the MariaDB root user without the proper authorisation.

You already have your root account protected, so you can safely answer 'n'.

Switch to unix_socket authentication [Y/n] n
 ... skipping.

You already have your root account protected, so you can safely answer 'n'.

Change the root password? [Y/n] Y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
 ... Success!


By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.

Remove anonymous users? [Y/n] y
 ... Success!

Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] y
 ... Success!

By default, MariaDB comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.

Remove test database and access to it? [Y/n] y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.

Reload privilege tables now? [Y/n] y
 ... Success!

Cleaning up...

All done!  If you've completed all of the above steps, your MariaDB
installation should now be secure.

Thanks for using MariaDB!
</code>

On créé la base :
<code bash>
mysql -u root -p
</code>
<code sql>
CREATE DATABASE bookstack;
CREATE USER 'bookadm'@'localhost' IDENTIFIED BY 'motdepassedelamort';
GRANT ALL ON bookstack.* TO 'bookadm'@'localhost'; 
</code>

===== Installer Composer =====
Installer [[https://getcomposer.org/|Composer]]. On va l'installer globalement parce je ne sais pas ce que je fais.

<code bash>
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

mv composer.phar /usr/local/bin/composer
composer
</code>

===== Installer BookStack =====

Récupérer BookStack
<code bash>
cd /var/www
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch
mv BookStack bookstack
cd bookstack
composer install --no-dev
cp .env.example .env
</code>

On continue les trucs de BookStack
<code bash>
php artisan key:generate
Sélectionner Yes
</code>

On édite le .env
<file conf .env>
APP_URL=https://bookstack.domaine.tld

DB_HOST=localhost
DB_DATABASE=bookstack
DB_USERNAME=root
DB_PASSWORD=mot de passe BDD
</file>

On bidouille les droits
<code bash>
chown -R www-data:www-data /var/www/bookstack
chmod -R 755 /var/www/bookstack
chmod -R 775 /var/www/bookstack/storage /var/www/bookstack/bootstrap/cache /var/www/bookstack/public/uploads
chmod 640 /var/www/bookstack/.env
</code>

Et on migre la base
<code bash>
php artisan migrate
</code>

===== Préparation vu vHost Apache =====

On créé le vHost Apache
<code bash>
nano /etc/apache2/site-available/bookstack.conf
</code>

Et on va honteusement piller [[https://codeberg.org/bookstack/devops/src/branch/main/config/apache/bookstack.conf|le modèle fourni par BookStack]] : 
<file apache bookstack.conf>
<VirtualHost *:80>

	# This is a simple example of an Apache VirtualHost configuration
	# file that could be used with BookStack.
	# This assumes mod_php has been installed and is loaded.
	#
	# Change the "docs.example.com" usage in the "ServerName" directive
	# to be your web domain for BookStack.
	#
	# Change the "/var/www/bookstack/public/", used twice below, to the
	# location of the "public" folder within your BookStack installation.
	#
	# This configuration is only for HTTP, Not HTTPS.
	# For HTTPS we recommend using https://certbot.eff.org/

	ServerName docs.example.com
	DocumentRoot /var/www/bookstack/public/

	<Directory /var/www/bookstack/public/>
		Options Indexes FollowSymLinks
		AllowOverride None
		Require all granted
		<IfModule mod_rewrite.c>
			<IfModule mod_negotiation.c>
				Options -MultiViews -Indexes
			</IfModule>

			RewriteEngine On

			# Handle Authorization Header
			RewriteCond %{HTTP:Authorization} .
			RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

			# Redirect Trailing Slashes If Not A Folder...
			RewriteCond %{REQUEST_FILENAME} !-d
			RewriteCond %{REQUEST_URI} (.+)/$
			RewriteRule ^ %1 [L,R=301]

			# Handle Front Controller...
			RewriteCond %{REQUEST_FILENAME} !-d
			RewriteCond %{REQUEST_FILENAME} !-f
			RewriteRule ^ index.php [L]
		</IfModule>
	</Directory>

	ErrorLog ${APACHE_LOG_DIR}/error.log
	CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</file>

On active le vHost
<code bash>
a2ensite bookstack.conf
systemctl reload apache2
</code>

===== Profit =====
Normalement tout est bon. Il reste à se connecter les identifiants par défaut : 
  * Compte : admin@admin.com
  * Mot de passe : password