Skip to main content

Updating BookStack

Update the base OS system:

sudo apt update && sudo apt upgrade -y

Screenshot 2022-11-10 234839.png

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.

Screenshot 2022-11-10 235425.png

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

Screenshot 2022-11-10 235524.png

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.

Screenshot 2022-11-11 000842.png

Update the database with any required changes.

php artisan migrate

Screenshot 2022-11-11 000935.png

Clear any local caches:

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

Screenshot 2022-11-11 001025.png

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

Screenshot 2022-11-11 001127.png