mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-05 00:29:48 +03:00
Ubuntu 20.04 Full Support #1685
Reference in New Issue
Block 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 @angelos-alexiou on GitHub (Apr 27, 2020).
Describe the bug
Empty Bookstack webpage on a fresh Ubuntu 20.04 Server Installation after importing (v0.29) database and files.
Steps To Reproduce
Steps to reproduce the behavior:
Expected behavior
The login page expects the defaults ("admin@admin.com" & "password") in order to login. After that, there is no data, just an empty Bookstack.
Your Configuration:
Any ideas / workarounds?
@ssddanbrown commented on GitHub (Apr 28, 2020):
Hi @angelos-alexiou,
Sorry to hear you're having some trouble with this.
You mention downloading an install script and making changes. We do have a script for Ubuntu20.04 here: https://github.com/BookStackApp/devops/blob/master/scripts/installation-ubuntu-20.04.sh
Does new new BookStack install work correctly, even though it has no content? What actions are you performing on step 4, to import the database into the new system?
@angelos-alexiou commented on GitHub (Apr 28, 2020):
Thanks @ssddanbrown for your immediate reply.
So, I try the new script as you mention above in a new machine. Here are my results:
And to answer your question above, I'm not sure if I'm using a wrong method of importing database & files for the Ubuntu 20.04. According to the documentation I use the followings (which work flawless in another Ubuntu 18.04 backup machine):
Importing SQL:
mysql -u bookstack -p bookstack < bookstack.backup.user.sqland then I enter my DB password
Importing Files:
sudo mv bookstack.files.backup.tar.gz /var/www/bookstackcd /var/www/bookstacksudo tar -xvzf bookstack.files.backup.tar.gzsudo chown www-data:www-data -R bootstrap/cache public/uploads storage && sudo chmod -R 755 bootstrap/cache public/uploads storageWhat am I doing wrong? Or is it that Ubuntu 20.04 (new php / mysql versions) needs an additional step(s)? Let me know what you think...
@ssddanbrown commented on GitHub (Apr 29, 2020):
@angelos-alexiou Thanks for the extra info.
If the same process worked for Ubuntu 20.04 then this could be down to MySQL8 being troublesome. Are you creating a MySQL user yourself at any point? If so you need to specifcy the authentication type to work with BookStack I think like so:
otherwise it's hard to tell. What white screen appears? Completely blank or mostly white with a message on it?
Otherwise you should be able to check the following logs for any clues:
storage/logs/laravel.log/var/log/apache2/error.log@Tzeenchist commented on GitHub (Apr 29, 2020):
@angelos-alexiou
Most likely, your question already contains an answer. Before installing, I recommend trying to remove the РHP8.
I installed it a couple of days ago in manual mode, there were no problems (Ubuntu 20.04, Nginx, PHP7.4, MariaDB)
@angelos-alexiou commented on GitHub (Apr 29, 2020):
@ssddanbrown: Thanks for the tips!
@Tzeenchist: Interesting fact for PHP v8.0...!!! Do you use any script or just copy/paste from "your notes"?
@ssddanbrown & @Tzeenchist: It seems that I need to investigate deeper this issue...
@ALL: I wonder how this will affect the project in the long run!! What will happen (for example) next year if someone sets up a new VPS using Ubuntu 20.04 & PHP8 and migrate data from an old setup? I guess that's my point of the issue "Ubuntu 20.04 Full Support". Is it possible to "automate" that process? If the project is packaged as snap, could solve these kind of issues?
@Tzeenchist commented on GitHub (Apr 30, 2020):
@angelos-alexiou
@angelos-alexiou commented on GitHub (Apr 30, 2020):
@Tzeenchist:
@ssddanbrown commented on GitHub (May 1, 2020):
@angelos-alexiou
Are you sure you're running PHP8? It's not even in alpha release until next month.
We won't be supporting Ubuntu specifically for the lifetime of a release, Generally the required PHP version for BookStack will move quicker than the default PHP versions on the Ubuntu LTS releases. That said you'll often still get by using the PHP PPA from Ondřej Surý. For Ubuntu LTS releases within reasonable range (That we have install scripts for) we'll generally advise of breaking changes in the update docs. Databases & web-servers evolve at a slower pace so are not usually an issue.
At the end of the day, this project is mostly maintained by myself in my free time, with community support. I could die tonight and any official support would end pretty abruptly, unless someone forks the project and commits to maintaining the fork.
I've actually had a dig into this recently. I like the idea but it'd be a surprising amount of effort required to maintain it in a way that ensure's it's secure. Plus I still feel the overall community is split on snaps, with a generally dislike, and it's mainly focused on Ubuntu (Although I know some level of support is there for other distros). Stepping back, I felt like docker achieves pretty much the same goal for something like BookStack but with wider support, Although I understand a snap could be easier for those without docker experience.
@Tzeenchist commented on GitHub (May 2, 2020):
@ssddanbrown
Such words scare more than the most terrible horror films. May your health be strong!
@angelos-alexiou commented on GitHub (May 3, 2020):
@ssddanbrown:
That's great!! 😃
As for your comments on Snaps, hey you are the leader (with all the help you get from the other contributors), so you (and others) will make necessary decisions for the project.
Besides time, what else you will need to keep it running? I would really like to help but I think my (programming) skills are limited for this project. I can help (if needed) with the translation into Greek language and try different things (testings, etc).
@angelos-alexiou commented on GitHub (May 3, 2020):
@All: Back to the issue... I have some updates:
I've setup a new (test) server in order to re-check everything, taking into account all of the above comments.
So I:
My Configuration:
I've said in the beginning that I've made some changes into the installation script (besides changing the default mechanism for creating a D/B password); that might be the root to my issue as described above.
Anyway, thanks for the comments and the support!!
@ssddanbrown commented on GitHub (Jul 11, 2020):
Great to read that you got this working. Will therefore close this off.
@jsreynolds commented on GitHub (Jul 29, 2020):
I wanted to add that I just went from 18.04 to 20.04 using an in-place upgrade. I am using Nginx instead of Apache. I had all the latest updates on 18.04.
My experience was that running the composer install and migrate commands off of the update page in documentation provided me with PHP extensions I needed to install. Unfortunately that didn't key me in to the remaining things I needed to install. I then reviewed the Ubuntu 20.04 install script provided, and picked out a few of the components I might be missing from the apt install line. After doing that, restarting php-fpm and nginx, things are working just fine again.
Great stuff - I really love the app, and getting another 5 or so years without having to futz about with stuff again is a godsend. All my upgrades of Bookstack have gone perfectly since day one. Thanks for all you do.
@ssddanbrown commented on GitHub (Jul 29, 2020):
@jsreynolds that's awesome to hear, thanks for the feedback. I spend a fair amount of effort to ensure a relatively smooth upgrade path so it's wonderful to hear the work pays off.