mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-16 19:06:45 +03:00
System CLI: download-vendor command feedback
#5225
Open
opened 2026-02-05 09:49:40 +03:00 by OVERLORD
·
22 comments
No Branch/Tag Specified
development
l10n_development
release
v25-12
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
pull-request
Mirrored from GitHub Pull Request
No Label
☕ Open to discussion
Milestone
No items
No Milestone
Projects
Clear projects
No project
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/BookStack#5225
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 @ssddanbrown on GitHub (Mar 17, 2025).
As per our blogpost here: https://www.bookstackapp.com/blog/php-dependency-improvements/
This is a thread to collection feedback about use of the download-vendor System CLI action, available from BookStack v25.02.1.
Once we've had a few rounds of feedback and confirmation of stable use, our update & install guidance, including future scripts, can be updated to make use of this instead of composer.
@Kirrus-Indiestone commented on GitHub (Aug 29, 2025):
Just used to upgrade to v25.07.2 from .1. No problems encountered. It did warn Alpha API during upgrade
@tjhart85 commented on GitHub (Sep 16, 2025):
I went from I believe 25.07 to 25.07.2 without a hitch.
The process felt very similar to the original method (I actually did one wiki using the old method and then a backup one using the alpha method) other than it warning of being alpha and seeing the bookstack URL.
All in all, I'd say it was pretty seamless.
The only way I could see it being better/easier is it it'd also clear the caches as part of the process (maybe as a selectable option):
@brynmoorhouse commented on GitHub (Sep 17, 2025):
Just updated to 25.07.2 - worked fine.
@theQuikest commented on GitHub (Oct 22, 2025):
Works great!
I do have a suggestion:
First check if there is anything to migrate, and if so, ask the question if you wish to migrate or not.
Now you get the question, it then checks and says "INFO Nothing to migrate."
@vrKiter commented on GitHub (Nov 13, 2025):
Updated successfully from 25.07.3 to 25.11.1 without issue. I do have a pretty basic Bookstack setup and all seems to be ok.
@jr-timme commented on GitHub (Nov 21, 2025):
I also just wanted to let you know, that we've been using the new cli command for the last couple of version upgrades and did not have any problems.
I also agree with the others that moving the other 4 artisan commands into the cli or calling them through a single command could be an improvement, even if it's not strictly necessary
@ssddanbrown commented on GitHub (Nov 23, 2025):
Thanks all so far for the input.
I have started using this command in scripts, and it's being used in some other places (like docker image builds) to roll it out further.
I've noted this as an option in our update docs now, and will probably make it the default early next year, especially as I'll use it in the Ubuntu 26.04 install script.
Within the system CLI there is already an update command which will run everything needed under-the-hood:
https://www.bookstackapp.com/docs/admin/system-cli/#update
This still uses composer though, so I'll add an issue to move that over to use download-vendor logic instead.
@zinksa commented on GitHub (Nov 26, 2025):
Just used it to upgrade to version v25.11.4. Worked flawlessly. Thank you ;)
@disposer-cloud commented on GitHub (Dec 15, 2025):
When running: ./bookstack-system-cli download-vendor I receive the following error message: Failed to download ZIP file from https://files.bookstackapp.com/vendor/v25.11.6.zip
@ssddanbrown commented on GitHub (Dec 15, 2025):
@disposer-cloud Are you able to access that link in the browser from where you are? From the server, are you able to
wget https://files.bookstackapp.com/vendor/v25.11.6.zipwithout issue?@tjhart85 commented on GitHub (Dec 15, 2025):
FWIW, it worked for me this morning going from 25.11.3 to 25.11.6 without issue.
@disposer-cloud commented on GitHub (Dec 15, 2025):
Thanks for the quick reply. I was thinking it was dns as it's always dns however it seems this time it was an egress geo block. I will re-run the update tonight and let you know!
@disposer-cloud commented on GitHub (Dec 16, 2025):
Should have known, the geo block was the issue. I was able to upgrade from 25.05.2 to v25.11.6 with no issues.
@RobNoVA commented on GitHub (Dec 26, 2025):
Just upgraded from 25.11.6 to 25.12 with no issues. Thank you! Ubuntu 24.04.3 LTS with MariaDB 10.11.13, PHP 8.3.12.
@LoosGuccreen commented on GitHub (Jan 23, 2026):
Tried to upgrade from 25.02.2 and couldn't, got this error:
@Kirrus-Indiestone commented on GitHub (Jan 23, 2026):
Do you have php-zip installed?
@LoosGuccreen commented on GitHub (Jan 23, 2026):
AFAIK it is installed (it's a shared hosting so I didn't do the install)
Unless "zip" and "php-zip" are two different things
@ssddanbrown commented on GitHub (Jan 24, 2026):
@LoosGuccreen What's the output of running
php -i | grep zip?@LoosGuccreen commented on GitHub (Jan 26, 2026):
@ssddanbrown I get this:
@ssddanbrown commented on GitHub (Jan 26, 2026):
@LoosGuccreen Okay, thanks, that confirms why that error is showing.
ZipArchive::RDONLYis only available when PHP is built against libzip >= 1.0.0. Your PHP version has been built against libzip0.11.2.Libzip 0.11.2 is from December 2013, so a 12 year old library at this point.
Libzip 1.0 was released in 2015.
Maybe we could add better handling for this constant not being available, but to be honest I think expecting usage of libraries less than 10 years old is reasonable, and that the main issue here is that your environment is making use of very old libraries. This is something I'd maybe raise with your hosting provider. If they offer different PHP versions, you can maybe try some newer ones in the hopes that they've been built using more recent libzip versions.
@Ionys320 commented on GitHub (Jan 29, 2026):
Hi,
It should be indicated somewhere (or checked by the CLI?) that, to download the ZIP using
@fopen($targetUrl, 'rb');, theallow_url_fopenPHP filesystem variable must be set toOn.Actually, if it's
Off, the download will just fail without telling why.@ssddanbrown commented on GitHub (Jan 31, 2026):
Thanks @Ionys320, I've opened an issue to improve this: https://codeberg.org/bookstack/system-cli/issues/25