Updating BookStack from v0.30.1 to the latest #5441

New Issue

OVERLORD · 2026-02-05T10:04:05+03:00

OVERLORD commented

2026-02-05 10:04:05 +03:00

Originally created by @VanGog86 on GitHub (Sep 29, 2025).

Attempted Debugging

I have read the debugging page

Searched GitHub Issues

I have searched GitHub for the issue.

Describe the Scenario

Hello!
Could you please advise me on how to update an old BookStack instance v0.30.1 on Debian 4.19.146-1 to the current version?

Exact BookStack Version

v0.30.1

Log Content

Hosting Environment

Debian 4.19.146-1

Originally created by @VanGog86 on GitHub (Sep 29, 2025). ### Attempted Debugging - [x] I have read the debugging page ### Searched GitHub Issues - [x] I have searched GitHub for the issue. ### Describe the Scenario Hello! Could you please advise me on how to update an old BookStack instance v0.30.1 on Debian 4.19.146-1 to the current version? ### Exact BookStack Version v0.30.1 ### Log Content ```text ``` ### Hosting Environment Debian 4.19.146-1

OVERLORD added the 🐕 Support label 2026-02-05 10:04:05 +03:00

OVERLORD closed this issue

2026-02-05 10:04:06 +03:00

OVERLORD commented

2026-02-05 10:04:08 +03:00

@ssddanbrown commented on GitHub (Sep 29, 2025):

Hello, would you be able to confirm your exact version of Debian in use? The version number provided doesn't really make sense. That would be a very, very old version from 2007.

In most Linux operating systems you can find the version by running cat /etc/os-release.

Also, if known, can you let me know what type of web server software you're using? (For example, Apache, Nginx) along with any information about the installation method or how you're running BookStack if known.

@ssddanbrown commented on GitHub (Sep 29, 2025): Hello, would you be able to confirm your exact version of Debian in use? The version number provided doesn't really make sense. That would be a very, very old version from 2007. In most Linux operating systems you can find the version by running `cat /etc/os-release`. Also, if known, can you let me know what type of web server software you're using? (For example, Apache, Nginx) along with any information about the installation method or how you're running BookStack if known.

OVERLORD commented

2026-02-05 10:04:09 +03:00

@VanGog86 commented on GitHub (Sep 29, 2025):

We are using a very old installation.
PRETTY_NAME="Debian GNU/Linux 10 (buster)"
NAME="Debian GNU/Linux"
VERSION_ID="10"
VERSION="10 (buster)"
VERSION_CODENAME=buster
ID=debian
We use nginx in our old enviroment

@VanGog86 commented on GitHub (Sep 29, 2025): We are using a very old installation. PRETTY_NAME="Debian GNU/Linux 10 (buster)" NAME="Debian GNU/Linux" VERSION_ID="10" VERSION="10 (buster)" VERSION_CODENAME=buster ID=debian We use nginx in our old enviroment

OVERLORD commented

2026-02-05 10:04:10 +03:00

@ssddanbrown commented on GitHub (Sep 30, 2025):

Thanks for the extra information @VanGog86.

As a general overview, my advice in regard to process approach would be the following:

Ensure you have good off-system backups before doing anything. And ideally a whole system snapshot or backup of some kind.
Update the operating system through to Debian13 (Trixie).
If using standard packages, the operating system upgrades should upgrade the database and web server and PHP packages in use. Although from our experience you can quite often need to re-install PHP packages due to version differences.
Once PHP, nginx and the database are confirmed to be successfully running, then I'd focus on updating BookStack itself following our standard update guidance where possible.

It's hard for me to provide specific guidance since I'm not exactly aware of how your environment may be configured and set up. With such a jump in both Debian and BookStack version, there's probably going to be some debugging to do at some level. But as long as you're not in a time sensitive rush to perform the update, you could start by going through the backup and Debian upgrade processes, and then I'd be happy to provide further guidance and debugging help when it comes to the latter stages if needed, via this issue thread.

@ssddanbrown commented on GitHub (Sep 30, 2025): Thanks for the extra information @VanGog86. As a general overview, my advice in regard to process approach would be the following: - Ensure you have good off-system [backups](https://www.bookstackapp.com/docs/admin/backup-restore/) before doing anything. And ideally a whole system snapshot or backup of some kind. - Update the operating system through to Debian13 (Trixie). - If using standard packages, the operating system upgrades should upgrade the database and web server and PHP packages in use. Although from our experience you can quite often need to re-install PHP packages due to version differences. - Once PHP, nginx and the database are confirmed to be successfully running, then I'd focus on updating BookStack itself following [our standard update guidance](https://www.bookstackapp.com/docs/admin/updates/) where possible. It's hard for me to provide specific guidance since I'm not exactly aware of how your environment may be configured and set up. With such a jump in both Debian and BookStack version, there's probably going to be some debugging to do at some level. But as long as you're not in a time sensitive rush to perform the update, you could start by going through the backup and Debian upgrade processes, and then I'd be happy to provide further guidance and debugging help when it comes to the latter stages if needed, via this issue thread.

OVERLORD commented

2026-02-05 10:04:11 +03:00

@ssddanbrown commented on GitHub (Oct 16, 2025):

Since there's been no further follow-up I'll go ahead and close this off.

@ssddanbrown commented on GitHub (Oct 16, 2025): Since there's been no further follow-up I'll go ahead and close this off.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#5441