]> BookStack Code Mirror - website/blob - content/docs/admin/updates.md
Script refresh, now compatible with RHEL 8.9 with PHP 8.1
[website] / content / docs / admin / updates.md
1 +++
2 title = "Updating BookStack"
3 description = "How to update BookStack to the latest version"
4 date = "2017-01-01"
5 type = "admin-doc"
6 +++
7
8 BookStack is updated regularly. We try our best to keep the platform and upgrade path as stable as possible. The latest release can be found on [GitHub here](https://github.com/BookStackApp/BookStack/releases) and detailed information on releases is posted on the [BookStack blog here](/tags/releases/).
9
10 **Before updating you should back up the database and any file uploads to prevent potential data loss**. <br>
11 Backup and restore documentation can be found [here](/docs/admin/backup-restore).
12
13  Updating is currently done via Git version control. To update BookStack you can run the three following commands in the root directory of the application:
14
15 ```bash
16 git pull origin release
17 composer install --no-dev
18 php artisan migrate
19 ```
20
21 This first command will update the repository that was created in the installation. The second will install the PHP dependencies using `composer`. The third will then update the database with any required changes.
22
23 In addition, Clearing the system caches is also recommended:
24
25 ```bash
26 php artisan cache:clear
27 php artisan config:clear
28 php artisan view:clear
29 ```
30
31 Check the below [Version Specific Instructions](#version-specific-instructions) list for the version you are updating to for any additional instructions.
32
33 When running update commands, your command line user will need permission to handle the required files and folders in the BookStack installation folder. You can find more details about [required filesystem permissions here](/docs/admin/filesystem-permissions/).
34
35 ---
36
37 ## Version Specific Instructions
38
39 The below lists things you may need to be aware of when upgrading to a newer version of BookStack. 
40 This is primarily a list of breaking changes & security notices.
41 Details of updates can be found on [our blog](https://www.bookstackapp.com/blog/) or via 
42 the [GitHub releases page](https://github.com/BookStackApp/BookStack/releases).
43
44 #### Updating to v24.02 or higher
45
46 **Comments** - The ability to use markdown content in comments has been removed in this release, replaced by a WYSIWYG editor. Markdown in comments was a fairly hidden feature though so was not commonly utilised. Existing markdown comments will remain although formatting may be lost if old markdown comments are edited.
47
48 **Commands** - The "Regenerate Comment Content" command has been removed in this release since this action is now redundant.
49
50 **OIDC Authentication** - Proof Key for Code Exchange (PKCE) support has been added to BookStack OIDC authentication. This should not affect existing OIDC use but you may want to enforce PKCE to be required for BookStack on your authentication system, if supported, for extra security.
51
52 #### Updating to v23.12.3 or higher
53
54 **Security** - v23.12.3 addresses a vulnerability in PDF generation that could be exploited, by users with the ability to create/edit/update page content, to perform blind server-side-request forgery.
55
56 #### Updating to v23.12 or higher
57
58 **Page Includes** - The way page include content is fetched & merged has changed significantly in this release, which in some cases may alter how included content appears on the page.
59
60 #### Updating to v23.10.3 or higher
61
62 **Security** - v23.10.3 addresses a vulnerability relating to image handling which could be exploited, by users with the ability to create/edit/update page content, to perform server-side requests or read the contents of files on the server system. Additionally, this update addresses a lack of permission check in some image creation actions.
63
64 #### Updating to v23.10 or higher
65
66 **User Detail/Preference Changes** - Many of the URLs, paths and interfaces for user-self management have changed in this release. You may need to update any documentation or user guidance you may have surrounding users updating their own details or preferences.
67
68 #### Updating to v23.08 or higher
69
70 **Security - Webhooks** - In scenarios where admin users are not trusted, webhooks could potentially be used maliciously. This update adds a control for such functionality. Please read [our documentation for the new `ALLOWED_SSR_HOSTS` option](/docs/admin/security/#server-side-request-allow-list) if this may be a concern for your instance.
71
72 #### Updating to v23.06.2 or higher
73
74 **Shelf Create Permissions** - If you upgraded specifically to v23.06 or v23.06.1, then create permissions for bookshelves would have been removed upon upgrade. If you made use of these via the "Copy Permissions to Books" action, or CLI command, then you will need to re-apply these permissions where required. If you jumped right over v23.06 and v23.06.1, then no permissions were removed.
75
76 #### Updating to v23.06.1 or higher
77
78 **Email Configuration (TLS)** - Due to issues experienced in v23.06, `MAIL_ENCRYPTION=ssl` or `MAIL_ENCRYPTION=tls` will now simply ensure that TLS or STARTTLS are used, rather than forcing full TLS to be used. Our [email documentation](https://www.bookstackapp.com/docs/admin/email-webhooks/) has been updated to reflect this.
79
80 #### Updating to v23.06 or higher
81
82 **Email Configuration** - If you've configured mail with `MAIL_ENCRYPTION=ssl` it's advised to test sending (via the button in "Settings > Maintenance") after updating to v23.06 since support for SSL has been dropped for email sending, but we instead now force TLS to be required when this option is set.  - *Note - this was amended further in v23.06.1 [(see above)](#updating-to-v23061-or-higher)*
83
84 **Font Customization** - The technique for customizing fonts has changed to be simpler, less fragile and more flexible. If customizing fonts it's advised to update to the new method as shown in our updated documentation on [changing fonts](/docs/admin/visual-customisation/#changing-fonts).
85
86 **Guest User Account** - Previously custom roles could be given to the "Guest" user account but permissions for those roles would not fully apply. That's been changed in v23.06 so additional role permissions fully apply but, as a precaution to prevent unexpected additional grant of permissions upon upgrade, any additional roles assigned to the "Guest" user will be removed upon update migration. If needed, simply re-assign any desired custom guest user roles after updating.
87
88 #### Updating to v23.05 or higher
89
90 **Page Include Tags** - Nesting is now allowed for [include tags](https://www.bookstackapp.com/docs/user/reusing-page-content/#include-tags), up to 3 levels of depth. You may now see more content loaded for pages which previously had unparsed nested include tags.
91
92 **SAML2** - Single LogOut (SLO) requests will now include a "session_index" for the current user. This technically brings BookStack's implementation closer to the spec, and is not expected to cause issues, but if using SLO it may be wise to check your identity provider behavior remains the same as before during logout.
93
94 **Custom Code Block Themes** - Due to a change of library, the method of defining custom codeblock themes has significantly changed, and "window.CodeTheme" code is no longer used. Refer to our ["Changing Code Block Themes"](https://www.bookstackapp.com/docs/admin/visual-customisation/#changing-code-block-themes) documentation for further information.
95
96 **Editor Event - editor-markdown::setup** - This event no longer contains "codeMirrorInstance" in the event data. It instead has a "cmEditorView" property. [See the event docs for more details](https://github.com/BookStackApp/BookStack/blob/development/dev/docs/javascript-public-events.md#editor-markdownsetup).
97
98 **Editor Event - editor-markdown-cm::pre-init** - This event has been renamed to "editor-markdown-cm6::pre-init" and no longer contains "config" in the event data. It instead has a "editorViewConfig" property. [See the event docs for more details](https://github.com/BookStackApp/BookStack/blob/development/dev/docs/javascript-public-events.md#editor-markdown-cm6pre-init).
99
100 **Upload Timeouts** - The use of "window.uploadTimeout" has been removed as a way to control upload timeouts. This would previously only be used in certain cases. Instead, if required, timeouts can usually be enforced at the web-server level.
101
102 #### Updating to v23.02 or higher
103
104 **PHP Version Requirement Change** - The minimum required version of PHP has changed from 7.4 to 8.0.2. This should not be a concern for those that are using common containers. Installations via our Ubuntu 22.04 install script are already using PHP 8.1 and therefore they don't need to be upgraded at this time.
105
106 For installs that have used our Ubuntu 18.04 and Ubuntu 20.04 install scripts, PHP can generally be upgraded to 8.2 using the below commands:
107
108 *Warning: If you run other applications on this machine, PHP applications in particular, then those may also be affected by these changes.*
109
110 ```bash
111 sudo apt update
112 sudo apt install software-properties-common
113 sudo add-apt-repository ppa:ondrej/php
114 sudo apt update
115 sudo apt install -y php8.2 php8.2-curl php8.2-mbstring php8.2-ldap php8.2-xml php8.2-zip php8.2-gd php8.2-mysql libapache2-mod-php8.2
116 sudo a2dismod php7.2 php7.4 php7.3 php8.0 php8.1
117 sudo a2enmod php8.2
118 sudo systemctl restart apache2
119 ```
120
121 You may also need to [update composer](#updating-composer) to be compatible with PHP 8.2.
122
123 **Logical Theme System Event Change** - The `commonmark_environment_configure` event argument and return type has changed. Please [see the event definition](https://github.com/BookStackApp/BookStack/blob/b88b1bef2c0cf74627c5122b656dfabc2d5f23ee/app/Theming/ThemeEvents.php#L63-L71) to understand the new types.
124
125 #### Updating to v23.01.1 or higher
126
127 **Security** - v23.01.1 patches a vulnerability in PDF generation that could be used to make server-side requests or run potential other PHP code.
128
129 #### Updating to v23.01 or higher
130
131 **Permission Changes** - There have been changes to the permission system which can affect how permissions apply and therefore could lead to changes in provided abilities upon update. This is only really relevant to complex permission scenarios that have only been possible since BookStack v22.10. Please see the [Permission System Changes section of the v23.01 blogpost](/blog/bookstack-release-v23-01/#permission-system-changes) for more details on this.
132
133 **Database Upgrade Time** - Changes to the permission system have required permissions to be regenerated upon update. Due to this, the `php artisan migrate` upgrade step may take extra time to run, especially where there's a lot of content and/or roles in the system.
134
135 #### Updating to v22.10 or higher
136
137 **Permission Management Changes** - The interface and logic for managing shelf, book, chapter & page permissions has changed significantly in this release. The following should be noted:
138   - Content permissions that were not active (where the "Enable Custom Permissions" checkbox was unchecked) will be removed upon upgrade to v22.10.
139   - Content permission role entries, that had no permissions provided, will not be reflected/shown as a row in the permissions interface immediately upon upgrade. Instead such cases will be reflected via the "Everyone Else" permission entry being active, in a non-inheriting state, with no permissions set.
140   - There should be no functional change to active permissions upon upgrade. Care has been taken to ensure existing permissions are migrated so that access control remains the same as pre-upgrade.
141
142 #### Updating to v22.09 or higher
143
144 **Revision Visibility** - This update fixes a permission disparity with revisions. Revision content has always been accessible to those with page-view permissions, but the links to the revisions list previously required page-edit permission to show. This has been aligned, which may mean page revision links may now show to those that did not previously see them.
145
146 **Revision Limit Change** - The default, per-page, revision limit has been doubled from 50 to 100, to account for new system-content updates that may occur. If desired, you can [configure this to a custom value](/docs/admin/other-config/#revision-limit).
147
148 **Reference Index** - New features have been added to track links between content in BookStack, which uses an internal reference index. Upon upgrade from an older BookStack version, this index will need to be rebuilt. This can be done with the ["Regenerate References" command](/docs/admin/commands/#regenerate-reference-index) or via the "Regenerate References" maintenance action within BookStack.
149
150 #### Updating to v22.07.3 or higher
151
152 **Security** - v22.07.3 added a "Content Security" section to the API docs and [BookStack documentation](/docs/admin/security/#using-bookstack-content-externally) with security considerations for using BookStack content externally. Read this new section if you are using BookStack user content externally.
153
154 #### Updating to v22.06 or higher
155
156 **SAML/LDAP Group Mapping** - Within the "External Authentication Ids" field for a BookStack role, a backslash followed by a comma (`\,`) will now cause the comma to be treated as a literal comma within the mapping name, instead of acting as a value separator to define multiple mappings.
157
158 #### Updating to v22.04 or higher
159
160 **Database Changes** - This release makes some significant changes to data within the database which may cause the update to take a little longer than usual to run. Please give the update extra time to complete.
161
162 **REST API Page Create/Update Changes** - Create & update page requests now have the potential to change the current editor type for that page, depending on the content type sent in the request, if the API user has permission to change the page editor.
163
164 **URL Handling** - The way we handle URLs has changed this release to hopefully address some issues in specific scenarios. These changes have been tested and should not affect existing working environments but there's an increased risk this release for setups with more complex URL handling. Please [raise an issue](https://github.com/BookStackApp/BookStack/issues/new/choose) or jump into our Discord server if you have any issues with URLs after upgrading.
165
166 #### Updating to v22.03 or higher
167
168 **Webhook Data Changes** - Properties found at the `related_item -> created_by/updated_by/owned_by` path of the webhook data will now be an object instead of an ID integer. If you were using these ids you'd now need to access them within the relevant objects. (For example `related_item.created_by.id`).
169
170 #### Updating to v22.02.3 or higher
171
172 **Security** - v22.02.3 adds controls to limit external/iframe content on BookStack pages to prevent potential malicious sources being used. See [the added "Iframe Source Control" section on our security page](/docs/admin/security/#iframe-source-control) for more detail regarding the added controls.
173
174 #### Updating to v22.02 or higher
175
176 **PHP Version Requirement Change** - The minimum required version of PHP has changed from 7.3 to 7.4. This should not be a concern for those that are using common containers or for those that have installed using our install scripts.
177
178 #### Updating to v21.12.3 or higher
179
180 **Composer Version Requirement Change** - Composer v2.0 or greater is now required to install or update BookStack. See the ["Updating Composer"](#updating-composer) section of this page below.
181
182 #### Updating to v21.12.1 or higher
183
184 **Security** - v21.12.1 better enforces permissions on book-sort & chapter-move operations to address scenarios where content could be moved to non-permissible locations.
185
186 #### Updating to v21.11.3 or higher
187
188 **Security** - v21.11.3 helps prevent potential discovery and harvesting of user details including name and email address.
189
190 #### Updating to v21.11.2 or higher
191
192 **Security** - v21.11.2 addresses a couple of vulnerabilities relating to API access
193 and page draft related content visibility. If the "Public" role was provided API access then the API could
194 be accessed, in certain scenarios, by non-authenticated users even if the "Allow public access" setting was disabled.
195 In some specific scenarios, content related to page drafts (Such as attachments) could be visible to non-owners 
196 (Whom would have permission to view the page if saved  as a non-draft at that point).
197
198 #### Updating to v21.11 or higher
199
200 **API Changes** - As of v21.11 any dates in API responses will be formatted as per ISO-8601, with `2019-12-02T20:01:00.283041Z` reflecting an example of this format. You may need to review any of your scripts that utilise dates from API responses.
201
202 **Upload Limit** - System file upload limits are now configured using a `FILE_UPLOAD_SIZE_LIMIT` option in your 
203   `.env` file. This value is specified as an integer and represents the max upload size in MegaBytes. This defaults to `50`. This replaces the old `window.uploadLimit` HTML head option that could be set.
204
205 **Search Index Changes** - Changes to search indexing and scoring were made in this release. 
206   It's recommended to run `php artisan bookstack:regenerate-search` to ensure a consistent search experience and take
207   advantage of these changes.
208
209 **Logout Endpoints** - Logout endpoints have now changed to be CSRF protected POST endpoints instead of GET endpoints. If you were using these for any external purposes you may now need to implement an alternative workflow.
210
211
212 #### Updating to v21.10.3 or higher
213
214 **Security** - v21.10.3 looks to address a couple of vulnerabilities within the attachment and image
215 serving mechanisms. The attachment vulnerability could result in users uploading content to be served
216 in a way that can be utilized for phishing. The image serving vulnerability could result in unintended
217 file access within your BookStack storage folder.
218
219 #### Updating to v21.10.1/v21.10.2 or higher
220
221 **Security** - Both v21.10.1 and v21.10.2 were released to address a vulnerability
222 which would allow malicious users, who have permission to update or create pages, to upload
223 content that could then be utilized for phishing or other general malicious intent.
224
225 #### Updating to v21.08.5 or higher
226
227 **Security** - v21.08.5 fixes a vulnerability which would allow malicious users, who have 
228 permission to update or create pages, to load content from files stored within
229 the `storage/` or `public/` directories (Such as application logs) via the
230 page HTML export system. In addition, this release adds stricter cache-control headers to http 
231 responses while logged in to prevent back navigation to authorized resources after logout.
232
233 #### Updating to v21.08.2 or higher
234
235 **Security** - v21.08.2 fixes a couple of XSS security vulnerability scenarios that could be achieved by malicious users that had permission to edit pages.
236   In addition, v21.08.2 introduces more [CSP rules](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) to help prevent any future XSS vulnerabilities from taking affect.
237   If you've performed some more advanced customizations on your instance, they may need to be altered to work with the built-in CSP system.
238
239 #### Updating to v21.08 or higher
240
241 **Config & Administration** - The introduction of multi-factor authentication brings the first use of encryption in the platform.
242   This uses the `APP_KEY` value in your `.env` file. Ensure you have this stored safely since it would be required if you ever
243   restore/migrate your instance to another system.
244
245 **Security/Exports** - During this release cycle it was highlighted that server-side request forgery could be achieved via the 
246   PDF export system. External fetching in the default PDF renderer has been disabled by default. The WKHTMLtoPDF renderer will now 
247   not be used if active. Either of these changes can be overridden by setting `ALLOW_UNTRUSTED_SERVER_FETCHING=true` in your `.env` file.
248   This should only be used were only trusted users can create and export content. To support this we've added permissions that allow disabling of exports per role.
249   
250 **Security/Authentication** - A slight change was made in relation to how email addresses are confirmed. Email confirmations are now primarily checked at point-of-login rather
251   than being checked on every request. Enabling email confirmation, or email domain restrictions, may no longer take action on unconfirmed users right away in the future.
252
253
254 #### Updating to v21.04 or higher
255
256 **Requirements Change** - The minimum required PHP version has changed from 7.2 to 7.3. If you originally updated using the Ubuntu 18.04 installation script, the below commands should help you to upgrade to PHP8:
257
258 ```bash
259 sudo add-apt-repository ppa:ondrej/php
260 sudo apt update
261 sudo apt install -y php8.0 php8.0-fpm php8.0-curl php8.0-mbstring php8.0-ldap php8.0-xml php8.0-zip php8.0-gd php8.0-mysql libapache2-mod-php8.0
262 sudo a2dismod php7.2
263 sudo a2enmod php8.0
264 systemctl restart apache2
265 ```
266
267 **User Reference Changes** - References to users in URLs of profile pages, and within search filters, has been changed to be name (Slugified) based instead of ID based. Old links or saved search filters may no longer work as expected.
268
269 #### Updating to v0.31.0 or higher
270
271 **Requirements Change** - The minimum required PHP version has changed from 7.2 to 7.2.5. Additionally, the `Tidy` PHP extension is no longer required.
272
273 **GitLab Authentication** - The `read_user` scope will now be passed and is required on the "Application" setup within GitLab. Not having this scope may lead to errors when users attempt to authenticate via GitLab.
274
275 **Security & IFrame Usage** - By default BookStack will set headers to prevent usage within an iframe. You can set trusted iframe hosts through the `ALLOWED_IFRAME_HOSTS` option in your `.env` file. See the [security page](/docs/admin/security#iframe-control) for more information on this option.
276
277 #### Updating to v0.30.6, v0.30.7 or higher
278
279 **Security** - v0.30.6 and v0.30.7 both address issues where page content could be visible to those without permission. If a chapter was visible to a user, but all of its pages were made not visible, then the details of these pages could be visible. Within the BookStack interface, the names of the pages and preview content could be seen. If the parent book was exported then this would include the content of the pages that had been restricted. If using BookStack v0.30.6, then all non-visible page content could be visible in plaintext exports. Please see the blog release pages for more details: [v0.30.6](/blog/beta-release-v0-30-6/), [v0.30.7](/blog/beta-release-v0-30-7/).
280
281 #### Updating to v0.30.5 or higher
282
283 **Security** - v0.30.5 fixes an potential vulnerability where a user with edit permissions could perform server-side requests using the export system. Additionally it was found that, if using standard email/password authentication, the system host URL could be manipulated on the forgot password form which could allow for email phishing attempts. Ensure you have set the `APP_URL` option in your `.env` file to help prevent this. Please see the [blog release page for more details](/blog/beta-release-v0-30-5/).
284
285 #### Updating to v0.30.4 or higher
286
287 **Security** - v0.30.4 fixes a couple of XSS vulnerabilities that could be exploited by untrusted users via page content and page link attachments. Please see the [blog release page for more details](/blog/beta-release-v0-30-4/).
288
289 #### Updating to v0.30 or higher
290
291 **Security** - Possible Privilege Escalation. During the v0.30 release cycle
292 it was advised that current privilege escalation situations are not made clear when applying role permissions.
293 Any user with a "Manage app settings", "Manage users" or "Manage roles & role permissions" system permission 
294 assigned to one of their roles could technically alter their own permissions to gain wider access.
295 A clear advisory of these cases has been added in the UI in v0.30
296 but admins are advised to review which users have these permissions with the above in mind.
297
298
299 **LDAP & SAML Group Matching** - During the v0.30 release cycle it was found that 
300 BookStack roles would be matched to LDAP/SAML groups based upon the role display name, which is expected,
301 but only those roles with a matching "name" value would be considered. This "name" field was redundant, 
302 and has now been removed, but it would store a cleaned version the first-set name of the role.
303 All roles will now be considered before being matched on name which may mean that roles which did not sync before, 
304 that would have been expected to based on their name, may now start to sync.
305
306
307 #### Updating to v0.29.3 or higher
308
309 **Security** - v0.29.3 fixes an issue where the names of restricted/private books could seen by those without permission, if added to a shelf. This issue was introduced in BookStack v0.28.0.
310
311 #### Updating to v0.29.2 or higher
312
313 **Security** - v0.29.2 fixes a XSS security vulnerability in the comment system, that was introduced in BookStack v0.18. Upon updating the command `php artisan bookstack:regenerate-comment-content` should be ran to regenerate comment content to ensure that it is safe.
314
315 #### Updating to v0.28 or higher
316
317 **Requirements Change** - Minimum PHP version has increased from 7.0.5 to 7.2.
318
319 If you installed BookStack on Ubuntu 16.04 using the install script, You should be able to upgrade your PHP version to 7.4 by running the following commands:
320
321 ```bash
322 sudo add-apt-repository -y ppa:ondrej/php
323 sudo apt update
324 sudo apt install -y php7.4 php7.4-fpm php7.4-curl php7.4-mbstring php7.4-ldap php7.4-tidy php7.4-xml php7.4-zip php7.4-gd php7.4-mysql
325 sudo sed -i.bak 's/php7\.0-fpm/php7.4-fpm/' /etc/nginx/sites-available/bookstack
326 sudo systemctl restart nginx.service
327 ```
328
329 #### Updating to v0.26 or higher
330
331 **Internet Explorer Support** - IE11 Support has now been dropped. Please use a modern browser.
332
333 **Translations** - Since many interfaces and lines of text have been updated, It may take a little while for some translations to catch-up. Expect to see more English text than usual if you're using a non-English language option.
334
335 **Images** - Due to changes how images are handled, as detailed below, some types of images may become inaccessible. Old logo images will be deleted when changed. Unused Book/Shelf cover images & User profile images will be become inaccessible after the update so you may want to delete them before upgrade.
336
337 **Security** - On previous versions of BookStack it was possible for users to insert JavaScript via the Markdown editor using `on*` html attributes. These will now be removed on page render unless you have set `ALLOW_CONTENT_SCRIPTS=true`. If untrusted users has access to your BookStack you may want to scan for `<<space_char>>on` in the HTML column of the pages table to identify any malicious intent.
338
339 #### Updating to v0.25.3 or higher
340
341 **Security** - On previous versions of BookStack it was possible to upload PHP files via the image upload endpoints. If you have a BookStack instance where untrusted users could upload image files, and you were using the default file storage option, It would have been possible for the user to access anything that the PHP process could. This would likely include, at minimum, any credentials stored in the `.env` file.
342
343 #### Updating to v0.25.2 or higher
344
345 **Configuration Change** - The .env option `REDIS_CLUSTER` has now been removed. If more than one redis server is provided they will automatically be clustered by BookStack.
346
347 #### Updating to v0.25 or higher
348
349 **Security** - During the release cycle for Version v0.25 it was found that page content includes could leak their content as preview text to users that don’t have permission to view the included content. It’s recommended to re-save any pages that included other page content that’s restricted to ensure included text is not shown in page preview text.
350
351 **Requirements Change** - Minimum required version of PHP has changed from 7.0.0 to 7.0.5.
352
353 **Configuration Change** - The .env option `GRAVATAR_URL=false` has been replaced by `AVATAR_URL=false`.
354
355
356 #### Updating to v0.24 or higher
357
358 Version v0.24 changes the way the homepage option is stored. After updating, You may need to re-configure this setting.
359
360 If updating from a much older BookStack version (Pre v0.20) you may need to update the permission and search indexes. You can do this by running the following commands from your BookStack install folder:
361
362 ```bash
363 php artisan bookstack:regenerate-search
364 php artisan bookstack:regenerate-permissions
365 ```
366
367 #### Updating to v0.19 or higher
368
369 Version v0.19 needs the following requirement change:
370
371 * Minimum required version of PHP has changed from 5.6.4 to 7.0.0.
372
373 #### Updating to v0.18 or higher
374
375 Version v0.18 introduced a commenting system. After updating you should check the permissions for all roles if you'd like to enable comments for your users.
376
377 #### Updating to v0.13 or higher
378
379 The v0.13 release contained some new features and updates which change the requirements of BookStack.
380
381 * Minimum required version of PHP has changed from 5.5.9 to 5.6.4.
382   Upgrade your PHP version if below 5.6.4.
383 * PHP-Tidy extension is now required.
384   - On Ubuntu 16.04 this can be installed via `sudo apt install php7.0-tidy`.
385   - On Ubuntu 14.04 (Using the default PHP option) this can be installed via `sudo apt-get install php5-tidy`.
386 * Page attachments will be stored in the `storage/uploads` folder (Unless you use Amazon S3). This folder will be created on update. Ensure your webserver has write permissions for this folder.
387
388 ---
389
390 ### Updating Composer
391
392 You can check your current composer version by running `composer -V`. 
393 You can often update composer by running `sudo composer self-update` (Or you may be prompted to run `sudo composer self-update --2`).
394
395 If you're using a system-supplied composer package you may need to first uninstall that (eg. `sudo apt remove composer`) then follow the [composer download documentation](https://getcomposer.org/download/) to get the latest version. Take notice of the `sudo mv composer.phar /usr/local/bin/composer` command shown in the documentation to install composer globally for easier usage.