Updating BookStack

Update the base OS system:

sudo apt update && sudo apt upgrade -y

If your BookStack Instance is running on a virtualized platform, it is a good idea to take a snapshot before proceeding to update BookStack application. Otherwise, make sure you have a backup of the BookStack database!

Navigate to your BookStack instance's root directory.

Official Update Documentation: https://www.bookstackapp.com/docs/admin/updates/

Updating BookStack is currently done via Git version control. Run the following command in the root directory to pull down the updates:

sudo git pull origin release

Update the PHP dependencies:

sudo composer install --no-dev

While the above command does warn you to not run composer as root or sudo user, on some Debian instances (like mine) the command will fail if it is not run as root or sudo user. Try running it without sudo first, and if it fails, try again with sudo.

Update the database with any required changes.

php artisan migrate

Clear any local caches:

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Refresh your BookStack URL page, and check that the version is updated in the Settings tab. As of 2022-11-11, the latest version is v22.10.2