Bookstack Rendering Issues: Unresolved Variables and Broken Links #4990

New Issue

OVERLORD · 2026-02-05T09:31:21+03:00

OVERLORD commented

2026-02-05 09:31:21 +03:00

Originally created by @dettmer-nh on GitHub (Oct 8, 2024).

Describe the Bug

As you can see on the screenshot, various Bookstack sections are no longer rendered correctly. You can only see various unresolved variables.

On the test instance, I was initially unable to open shelves. I ran all update commands again (even though the system was already up to date), but now I can't even render the login page.

On the production instance, I'm able to navigate, create and view pages but i get the same bug when trying to delete pages. Also all buttons and links on the unrendered page lead to invalid URLs with unresolved variables inside.

Unfortunately, this problem was not noticed during the first tests on 20 September (time of the update). Therefore, the productive environment has been running like this since then. I hope I can save all the new posts that have been created since then, somehow.

Steps to Reproduce

I am not aware of the exact steps, but this problem has occurred in two instances after updating from version 24.02.3 to the latest version. The required steps such as updating the PHP and Composer version were also executed.

Host system: Virtual machine with Ubuntu 20.04.6 LTS

Expected Behaviour

The site should render correctly.

Screenshots or Additional Context

Browser Details

Microsoft Edge Version 129.0.2792.79 (64-Bit) and also Firefox 128.3.0esr (64-Bit) both for Windows

Exact BookStack Version

v24.05.4

Originally created by @dettmer-nh on GitHub (Oct 8, 2024). ### Describe the Bug As you can see on the screenshot, various Bookstack sections are no longer rendered correctly. You can only see various unresolved variables. On the test instance, I was initially unable to open shelves. I ran all update commands again (even though the system was already up to date), but now I can't even render the login page. On the production instance, I'm able to navigate, create and view pages but i get the same bug when trying to delete pages. Also all buttons and links on the unrendered page lead to invalid URLs with unresolved variables inside. Unfortunately, this problem was not noticed during the first tests on 20 September (time of the update). Therefore, the productive environment has been running like this since then. I hope I can save all the new posts that have been created since then, somehow. ### Steps to Reproduce I am not aware of the exact steps, but this problem has occurred in two instances after updating from version 24.02.3 to the latest version. The required steps such as updating the PHP and Composer version were also executed. Host system: Virtual machine with Ubuntu 20.04.6 LTS ### Expected Behaviour The site should render correctly. ### Screenshots or Additional Context ![prod_instance_delete](https://github.com/user-attachments/assets/441f6f89-1b9b-41a6-836a-66b26d0f00f4) ![prod_instance_invalidlink](https://github.com/user-attachments/assets/d79b1d42-830d-491a-9e46-14afd53be29c) ![test_instance-login](https://github.com/user-attachments/assets/c7781db9-c952-408b-97ee-d914db0f85e5) ### Browser Details Microsoft Edge Version 129.0.2792.79 (64-Bit) and also Firefox 128.3.0esr (64-Bit) both for Windows ### Exact BookStack Version v24.05.4

OVERLORD added the 🐛 Bug label 2026-02-05 09:31:21 +03:00

OVERLORD closed this issue

2026-02-05 09:31:24 +03:00

OVERLORD commented

2026-02-05 09:31:27 +03:00

@ssddanbrown commented on GitHub (Oct 8, 2024):

Hi @dettmer-nh,
This could possible be related to permission and caches set/existing on your instance.

Before anything, ensure you have a backup of your instance (ideally a whole system snapshot/backup)

Can you have a go at resetting file permissions for your instance as per out guidance here: https://www.bookstackapp.com/docs/admin/filesystem-permissions/#example-permissions-approach

Then, try running the following from your BookStack install directory, reporting back any errors that may show:

php artisan optimize:clear
php artisan view:clear
php artisan route:clear

Then also restart apache to ensure there's no web-server/php caching at that level:

sudo systemctl restart apache2

@ssddanbrown commented on GitHub (Oct 8, 2024): Hi @dettmer-nh, This could possible be related to permission and caches set/existing on your instance. Before anything, ensure you have a backup of your instance (ideally a whole system snapshot/backup) Can you have a go at resetting file permissions for your instance as per out guidance here: https://www.bookstackapp.com/docs/admin/filesystem-permissions/#example-permissions-approach Then, try running the following from your BookStack install directory, reporting back any errors that may show: ```bash php artisan optimize:clear php artisan view:clear php artisan route:clear ``` Then also restart apache to ensure there's no web-server/php caching at that level: ```bash sudo systemctl restart apache2 ```

OVERLORD commented

2026-02-05 09:31:31 +03:00

@dettmer-nh commented on GitHub (Oct 8, 2024):

Hi @ssddanbrown,

Thank you so much for your help! I followed the steps you outlined, including resetting the file permissions and running the suggested commands. Fortunately, no errors occurred, and everything seems to be functioning properly again.

I really appreciate your guidance and quick response. Thanks again for the support!

@dettmer-nh commented on GitHub (Oct 8, 2024): Hi @ssddanbrown, Thank you so much for your help! I followed the steps you outlined, including resetting the file permissions and running the suggested commands. Fortunately, no errors occurred, and everything seems to be functioning properly again. I really appreciate your guidance and quick response. Thanks again for the support!

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#4990