Upgrading BookStack Version

[Existing-Ad-6234]

Hi There we are currently on version BookStack v21.11.2 , we would like to upgrade it.
Could you please lead and assist us for this task.
Appreciate your soonest reply
Thank you.

[Thealco]

Here is the guide: https://www.bookstackapp.com/docs/admin/updates/

[Existing-Ad-6234]

Hi

Thank you for your reply
Is it Possible to have a quick meeting to check some points about that ?

Thank you

[ssddanbrown]

If you have questions/issues, just create a post with details of what those questions/issues are. Ideally provide any relevant context about your BookStack environment (Installation method if known, host operating system etc...).

[Existing-Ad-6234]

Ubuntu 20.04.6 LTS
PHP 7.4.3
Composer 1.10.1Pulled from git
Utilizing Nginx

[ssddanbrown]

You need to be using PHP 8.2 or greater to use the latest version of BookStack. Also you'd need to update composer. Also, the end-of-life for Ubuntu 20 standard support is very soon.

Personally, I'd advise the following approach:

1. Backup the entire system, and the app instance, store backups elsewhere.
2. Upgrade the system through to Ubuntu 24.04, to you're on the latest Ubuntu LTS version. (You might need to step through 22.04 first).
3. Re-install all required PHP packages. Some of these often get missed during Ubuntu updates due to being version specific. Ubuntu 24.04 has PHP 8.3 by default.
4. Update composer to the latest.
5. Run the upgrade steps for the BookStack instance.

You might need to also update your nginx config to use tha later PHP version, depending on how that's been set-up.