BookStackApp
System CLI: `download-vendor` command feedback
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.
Just used to upgrade to v25.07.2 from .1. No problems encountered. It did warn Alpha API during upgrade
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):
- php artisan cache:clear
- php artisan config:clear
- php artisan view:clear
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."
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.
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
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.
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
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.
Just used it to upgrade to version v25.11.4. Worked flawlessly. Thank you ;)
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
@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.zip without issue?
FWIW, it worked for me this morning going from 25.11.3 to 25.11.6 without issue.
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!
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.