mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-05 00:29:48 +03:00
Unable to access Bookstack after upgrade to v21.04 #2189
Closed
opened 2026-02-05 03:15:46 +03:00 by OVERLORD
·
9 comments
No Branch/Tag Specified
development
l10n_development
further_theme_development
release
llm_only
vectors
v25-11
docker_env
drawio_rendering
user_permissions
ldap_host_failover
svg_image
prosemirror
captcha_example
fix/video-export
v25.12.3
v25.12.2
v25.12.1
v25.12
v25.11.6
v25.11.5
v25.11.4
v24.11.4
v25.11.3
v25.11.2
v25.11.1
v25.11
v25.07.3
v25.07.2
v25.07.1
v25.07
v25.05.2
v25.05.1
v25.05
v25.02.5
v25.02.4
v25.02.3
v25.02.2
v25.02.1
v25.02
v24.12.1
v24.12
v24.10.3
v24.10.2
v24.10.1
v24.10
v24.05.4
v24.05.3
v24.05.2
v24.05.1
v24.05
v24.02.3
v24.02.2
v24.02.1
v24.02
v23.12.3
v23.12.2
v23.12.1
v23.12
v23.10.4
v23.10.3
v23.10.2
v23.10.1
v23.10
v23.08.3
v23.08.2
v23.08.1
v23.08
v23.06.2
v23.06.1
v23.06
v23.05.2
v23.05.1
v23.05
v23.02.3
v23.02.2
v23.02.1
v23.02
v23.01.1
v23.01
v22.11.1
v22.11
v22.10.2
v22.10.1
v22.10
v22.09.1
v22.09
v22.07.3
v22.07.2
v22.07.1
v22.07
v22.06.2
v22.06.1
v22.06
v22.04.2
v22.04.1
v22.04
v22.03.1
v22.03
v22.02.3
v22.02.2
v22.02.1
v22.02
v21.12.5
v21.12.4
v21.12.3
v21.12.2
v21.12.1
v21.12
v21.11.3
v21.11.2
v21.11.1
v21.11
v21.10.3
v21.10.2
v21.10.1
v21.10
v21.08.6
v21.08.5
v21.08.4
v21.08.3
v21.08.2
v21.08.1
v21.08
v21.05.4
v21.05.3
v21.05.2
v21.05.1
v21.05
v21.04.6
v21.04.5
v21.04.4
v21.04.3
v21.04.2
v21.04.1
v21.04
v0.31.8
v0.31.7
v0.31.6
v0.31.5
v0.31.4
v0.31.3
v0.31.2
v0.31.1
v0.31.0
v0.30.7
v0.30.6
v0.30.5
v0.30.4
v0.30.3
v0.30.2
v0.30.1
v0.30.0
v0.29.3
v0.29.2
v0.29.1
v0.29.0
v0.28.3
v0.28.2
v0.28.1
v0.28.0
v0.27.5
v0.27.4
v0.27.3
v0.27.2
v0.27.1
v0.27
v0.26.4
v0.26.3
v0.26.2
v0.26.1
v0.26.0
v0.25.5
v0.25.4
v0.25.3
v0.25.2
v0.25.1
v0.25.0
v0.24.3
v0.24.2
v0.24.1
v0.24.0
v0.23.2
v0.23.1
v0.23.0
v0.22.0
v0.21.0
v0.20.3
v0.20.2
v0.20.1
v0.20.0
v0.19.0
v0.18.5
v0.18.4
v0.18.3
v0.18.2
v0.18.1
v0.18.0
v0.17.4
v0.17.3
v0.17.2
v0.17.1
v0.17.0
v0.16.3
v0.16.2
v0.16.1
v0.16.0
v0.15.3
v0.15.2
v0.15.1
v0.15.0
v0.14.3
v0.14.2
v0.14.1
v0.14.0
v0.13.1
v0.13.0
v0.12.2
v0.12.1
v0.12.0
v0.11.2
v0.11.1
v0.11.0
v0.10.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0
v0.8.2
v0.8.1
v0.8.0
v0.7.6
v0.7.5
v0.7.4
v0.7.3
0.7.2
v.0.7.1
v0.7.0
v0.6.3
v0.6.2
v0.6.1
v0.6.0
v0.5.0
Labels
Clear labels
🎨 Design
📖 Docs Update
🐛 Bug
🐛 Bug
:cat2:🐈 Possible duplicate
💿 Database
☕ Open to discussion
💻 Front-End
🐕 Support
🚪 Authentication
🌍 Translations
🔌 API Task
🏭 Back-End
⛲ Upstream
🔨 Feature Request
🛠️ Enhancement
🛠️ Enhancement
🛠️ Enhancement
❤️ Happy feedback
🔒 Security
🔍 Pending Validation
💆 UX
📝 WYSIWYG Editor
🌔 Out of scope
🔩 API Request
:octocat: Admin/Meta
🖌️ View Customization
❓ Question
🚀 Priority
🛡️ Blocked
🚚 Export System
♿ A11y
🔧 Maintenance
> Markdown Editor
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/BookStack#2189
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @techauthoruk on GitHub (Apr 12, 2021).
Describe the bug
After upgrading to v21.04, I can no longer access my instance of Bookstack - I just get 'An unknown error occured' message
This is the trace log after running
git pull origin release && composer install --no-dev && php artisan migrate:Steps To Reproduce
Steps to reproduce the behavior:
git pull origin release && composer install --no-dev && php artisan migrateExpected behavior
That the application would be accessible
Screenshots

If applicable, add screenshots to help explain your problem.
This is the screen I see - I cannot access the home page or log in:
Your Configuration (please complete the following information):
Additional context
Reverting to php7.4 allows access to the application, but I do not see any of the new features. I have tried several browsers (Chrome, Firefox and Opera), all with the same result. Clearing the browser cache makes no difference. Although reverting to PHP7.4 allows access, some features now do not work - cannot add a user for instance.
@diegopau commented on GitHub (Apr 12, 2021):
I had the exact same issue.
I am running BookStack in a DigitalOcean droplet with Ubuntu 20.04.
I am rolling back to a previous snapshot of the droplet for now.
@ssddanbrown commented on GitHub (Apr 12, 2021):
Hi @diegopau and @techauthoruk,
For now you can remain on php7.4 and attempt the update via php7.4 instead of also updating to php8 at the same time. PHP7.4 will probably still be supported by BookStack for at least another year or so.
My initial guess at the error would be use of an old composer version that does not have PHP8 support.
You can get your composer version by running
composer -v. If you've installed composer via your system packages (apt/yum) then it it quite likely to be an old version.You might be able to get away with running
sudo composer self-updatebut it'll depend on version and what PHP version you have installed. If you do have the system package version you may need to uninstall it and install composer manually by:sudo mv composer.phar /usr/local/bin/composerto install globally (Assuming a linux based system).@techauthoruk commented on GitHub (Apr 12, 2021):
Hi Dan
Composer version 2.0.12
I have tried the suggestions you made, but it doesn't resolve the issue - any further suggestions? Also how can I revert to the previous release - is there an easy way to do this?
@Mynster9361 commented on GitHub (Apr 12, 2021):
I have the same problem.
If i set my PHP version to 8.0.3 i get the same error,
I have upgraded composer since then from 1.6.3 to 2.0.12
If i set PHP version to use 7.4 everything works fine.
If i run

composer check-platform-reqsin the bookstack directory i get the following:Seems to be the random_combat application that has not been updated for php version 8

bookstack/vendor/paragonie/random_compat/composer.json
Hope it helps in the troubleshooting unfortunately i am not very well versed in coding so i do not believe am able to resolve it
@ssddanbrown commented on GitHub (Apr 13, 2021):
@Mynster9361 While the
random_compatdoes version does not technically meet requirements, it should not be an issue here unless composer is specifically warning about that library when installing.I've just ran some tests within a fresh Ubuntu 20.04 VM. I could reproduce the errors shown when using the
composersystem package via php8, but could install and run fine when directly using the latest version of composer. The error logs provided above come from the system built-in composer, looking at the paths in the error log.Please ensure the system composer package is completely removed (
sudo apt remove composer) before reinstalling composer then re-running the update commands. If this is still erroring, after being sure you're not using the system-package composer, but a fresh new composer download, please provide the error logs you see.If you do want to migrate back, You'll need to do something like this in your BookStack install (BACKUP FIRST):
I don't think you need to revert the database at all since I don't think you've got to that step.
@techauthoruk commented on GitHub (Apr 13, 2021):
@ssddanbrown - Thank you for the help Dan. Uninstalling composer and then reinstalling, and re-running the Bookstack update solved the issue (I kept php8.0)
Mark
@diegopau commented on GitHub (Apr 13, 2021):
Thank you. It worked for me too: Uninstalled composer, then followed the steps to have the latest composer version available, then upgraded to PHP 8 and I could upgrade now Bookstack without issues.
@Mynster9361 commented on GitHub (Apr 13, 2021):
@ssddanbrown
I seem to have missed the information of the ubuntu version in this issue.
I am/was on version 18.04 and here i was not able to get it resolved by running the following
sudo apt remove composercomposer was still installed unfortunately so i tried to uninstall it by the information here
https://www.itechempires.com/2019/09/how-to-uninstall-and-install-composer-in-ubuntu/
After that i installed composer again with the 4 commands followed by the one you provided
https://getcomposer.org/download/
sudo mv composer.phar /usr/local/bin/composerUnfortunately the issue was still not resolved
So instead i have installed a fresh version of ubuntu 20.04 and restored my DB and settings from my previous bookstack server.
So for me the issue is resolved by upgrading but i do not know if the issue persist if you try and boot up a new ubuntu 18.04
@ssddanbrown commented on GitHub (Apr 13, 2021):
Thanks everyone for confirm what fixed their instance, I'll therefore close this off.