Updating BookStack (Debian 10)

In this chapter we will update the installed BookStack instance within a mayor release under Debian 10. Usually no update of the dependencies should be necessary - but this should be checked in the official admin guide first.

Preparation

Before updating, it is recommended to make a backup of the BookStack directory as well as the database. This can be done as follows:

tar cfvj ~/backup_bookstack.tar.bz2 /var/www/bookstack
mysqldump -u root -p bookstack > ~/backup_bookstack_db.sql

Update

First, we get the latest version from the official Git repository:

cd /var/www/bookstack
git pull origin release

Now we perform the installation of the PHP dependencies via composer:

curl -s https://getcomposer.org/installer > composer-setup.php
php composer-setup.php --quiet
rm -f composer-setup.php
export COMPOSER_ALLOW_SUPERUSER=1
php composer.phar install --no-dev --no-plugins

And finally, we update the database:

php artisan migrate --no-interaction --force

Verification

After performing the update, you should of course immediately check whether everything is working as usual. The currently installed version can be found in the menu item "Settings" in the upper right corner.