Arch Linux User Repository

If someone has free time, please add the information below and more to https://wiki.archlinux.org/title/BookStack

One can take inspiration from https://wiki.archlinux.org/title/Nextcloud for the style, as Nextcloud is also a PHP app.

See https://www.bookstackapp.com/docs/admin/updates/#version-specific-instructions for breaking changes between versions.

Updates might require intervention, this can be automated via a pacman hook.

/etc/pacman.d/hooks/bookstack.hook

[Trigger]
Operation = Install
Operation = Upgrade
Type = Package
Target = bookstack

[Action]
Description = Update BookStack installation
When = PostTransaction
Exec = /usr/bin/runuser -u http -- /bin/bash -c "/usr/bin/php /usr/share/webapps/bookstack/artisan migrate --force && /usr/bin/php /usr/share/webapps/bookstack/artisan cache:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan config:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan view:clear"

If using php-fpm (or legacy), one needs to add an override for the upload folder:

/etc/systemd/system/php-fpm.service.d/override.conf

[Service]
ReadWritePaths=/usr/share/webapps/bookstack/public/uploads

@klemmi you can create a hook (/etc/pacman.d/hooks/bookstack.hook) to do that automatically. This is mine:

[Trigger]
Operation = Install
Operation = Upgrade
Type = Package
Target = bookstack

[Action]
Description = Update BookStack installation
When = PostTransaction
# https://www.bookstackapp.com/docs/admin/updates/
Exec = /usr/bin/runuser -u http -- /bin/bash -c "/usr/bin/php /usr/share/webapps/bookstack/artisan migrate --force && /usr/bin/php /usr/share/webapps/bookstack/artisan cache:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan config:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan view:clear"

I updated bookstack using yay and at some point, I got the issue documented here: https://github.com/BookStackApp/BookStack/issues/4787

php artisan migrate

in the usr/share/webapps/bookstack solved it for me. Maybe this can be implemented in the PKGBUILD as step?

If someone has free time, please add the information below and more to https://wiki.archlinux.org/title/BookStack

One can take inspiration from https://wiki.archlinux.org/title/Nextcloud for the style, as Nextcloud is also a PHP app.

See https://www.bookstackapp.com/docs/admin/updates/#version-specific-instructions for breaking changes between versions.

Updates might require intervention, this can be automated via a pacman hook.

/etc/pacman.d/hooks/bookstack.hook

[Trigger]
Operation = Install
Operation = Upgrade
Type = Package
Target = bookstack

[Action]
Description = Update BookStack installation
When = PostTransaction
Exec = /usr/bin/runuser -u http -- /bin/bash -c "/usr/bin/php /usr/share/webapps/bookstack/artisan migrate --force && /usr/bin/php /usr/share/webapps/bookstack/artisan cache:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan config:clear && /usr/bin/php /usr/share/webapps/bookstack/artisan view:clear"

If using php-fpm (or legacy), one needs to add an override for the upload folder:

/etc/systemd/system/php-fpm.service.d/override.conf

[Service]
ReadWritePaths=/usr/share/webapps/bookstack/public/uploads

For those experiencing broken rendering with non-latin/special characters, simply make sure your system is up to date and open and save the affected pages.

https://github.com/BookStackApp/BookStack/issues/4701

If you run into Class "Laravel\Ui\UiServiceProvider" not found or a similar error during a migration to a newer version, you may need to run COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --ignore-platform-reqs --no-interaction in /usr/share/webapps/bookstack directly as root.

Fear not, this is the same package you've been using.

The package was deleted by the previous owner who also deleted their account, which is why it appears fresh after I took over despite being almost 2 years old.