]> BookStack Code Mirror - website/commitdiff
Added v24.05.1 update notes, fixed some other minor parts
authorDan Brown <redacted>
Thu, 23 May 2024 12:37:50 +0000 (13:37 +0100)
committerDan Brown <redacted>
Thu, 23 May 2024 12:37:50 +0000 (13:37 +0100)
content/docs/admin/debugging.md
content/docs/admin/updates.md
themes/bookstack/layouts/index.html

index b7654852742619da76de41068d2e3c0c7c54f59f..cacd01c484b0dd1de663ff0e22b08355fda08a52 100644 (file)
@@ -20,6 +20,8 @@ This page details how you can find out more information about errors you may fac
     - [Broken Links or No Images After APP_URL Change](#broken-links-or-no-images-after-app_url-change)
 - [Submitting Issues](#submitting-issues)
 
+---
+
 ### Error Log File
 
 On a common installation, an error log can be found at the path `storage/logs/laravel.log`, relative to the top-level folder of your BookStack installation files. 
@@ -36,12 +38,16 @@ You will likely need privileged access to read these files. For example `sudo ta
 
 If using an alternative hosting method, such as docker container, please refer to the documentation provided by that method/container.
 
+---
+
 ### Debug View
 
 _**NOTE: When debugging is enabled it's possible for visitors to see private credentials used in the BookStack or server configuration. Ensure debugging is only enabled when your instance is not accessible by others. Remember to disable debugging before restoring access.**_
 
 To enable full error displaying edit the `.env` file, in the application root directory, and add or update the `APP_DEBUG` option to `APP_DEBUG=true`. Errors will now be displayed in full with details of where it occurred. Remember to revert this change once you have found the issue so that the detailed error information is hidden from visitors.
 
+---
+
 ### Common Issues & Resolutions
 
 The below lists some of the common issues we see, when it comes to installing & maintaining BookStack, and their usual resolutions.
@@ -50,7 +56,7 @@ The below lists some of the common issues we see, when it comes to installing &
 
 A completely blank screen, when attempting to access your BookStack instance, is commonly due to system/folder permission issues.
 Check that webserver user has read/write access to the `bootstrap/cache`, `storage` and `public/uploads` folders within your BookStack install.
-On a common Ubuntu install this can usually be done by running `sudo chown -R www-data:www-data bootstrap/cache storage public/uploads` from within the BookStack install folder.
+On a common Ubuntu install this can usually be done by running `sudo chown -R www-data:www-data bootstrap/cache storage public/uploads` from within the BookStack install folder. We have further guidance on filesystem permissions [on our page here](/docs/admin/filesystem-permissions/).
 
 If you don't believe this is due to permissions, and you have nothing in the `storage/logs/laravel.log` file as detailed above, you'd next want to look at your webserver error logs which can commonly be found within `/var/log/nginx/` or `/var/logs/apache2/`.
 
@@ -96,6 +102,8 @@ php artisan bookstack:update-url <oldUrl> <newUrl>
 php artisan bookstack:update-url http://docs.example.com https://demo.bookstackapp.com
 ```
 
+---
+
 ### Submitting Issues
 
 If you have found the cause of the issue, and it is not an issue with your particular setup, you can submit it on the [GitHub issues page](https://github.com/BookStackApp/BookStack/issues). Please include as much information as possible when creating an issue along with steps detailing how to replicate it so the bug can be fixed by a developer.
index 709c7dee46f914c5e38cf6c09434ff92c8109608..251d5ba5bd2545704b6b1d59691ff0fa52b29b2f 100644 (file)
@@ -41,6 +41,10 @@ This is primarily a list of breaking changes & security notices.
 Details of updates can be found on [our blog](https://www.bookstackapp.com/blog/) or via 
 the [GitHub releases page](https://github.com/BookStackApp/BookStack/releases).
 
+#### Updating to v24.05.1 or higher
+
+**Security** - v24.05.1 adds extra rate-limiting to some forms that are accessible without authentication, while also implementing changes to prevent methods that could be used to indicate if specific user emails exist in the system.
+
 #### Updating to v24.05 or higher
 
 **PHP Version Requirement Change** - The minimum supported PHP version has changed from PHP 8.0.2 to PHP 8.1 in this release. Please see our ["Updating PHP & Composer" documentation page](https://www.bookstackapp.com/docs/admin/updating-php/#updating-php) for guidance on updating PHP.
index 7b0dd8a4e84839dd8621c180a931aa94039a3d22..63939639d250214609e0d798def8034baf5c41d3 100644 (file)
@@ -39,7 +39,7 @@
         <div class="row">
             <div class="col-sm-4">
                 <h4><span class="icon" aria-hidden="true">{{partial "icon/code.svg"}}</span>Free &amp; Open Source</h4>
-                <p>BookStack is fully free and open, MIT licensed. The source is available on GitHub. There is no cost to downloading and installing your own instance of bookstack.
+                <p>BookStack is fully free and open, MIT licensed. The source is available on GitHub. There is no cost to downloading and installing your own instance of BookStack.
                 </p>
                 <p>
                     <a href="https://github.com/BookStackApp/BookStack">View the source here &raquo;</a>