# Upgrading Signature

### About Signature

Welcome to Signature, your go-to destination for knowledge and information! Signature is powered by BookStack, a versatile and user-friendly platform designed to streamline the creation and management of documentation.

### Technical Details

- **Powered by BookStack**: Signature utilizes BookStack, a powerful and intuitive documentation platform.
- **Data Centre:** Hosted in the Azure South-Africa region, ensuring reliability and performance for our users in the local area.
- **Last Updated Version**: v24.02.3
- **Last Updated Date**: \[Insert Date\]

### Upgrade history

<table id="bkmrk-version-date-locatio"><thead><tr><th>Version</th><th>Date</th><th>Location</th><th>Upgraded by</th><th>Description</th></tr></thead><tbody><tr><td>21.12.3</td><td>2022-06-01</td><td>AWS \[Version 9\]</td><td>Hendré / Christiaan Nel</td><td>This version was set up in a container on Ubuntu 18.04</td></tr><tr><td>24.02.3</td><td>2024-04-26</td><td>Azure South-Africa</td><td>Hendré</td><td>Migrated from container to stand-alone on Ubuntu 22.04</td></tr></tbody></table>

### Upgrading Bookstack

BookStack is updated regularly. 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](https://www.bookstackapp.com/tags/releases/).

<p class="callout warning">**Before updating you should back up the database and any file uploads to prevent potential data loss**.  
Backup and restore documentation can be found [here](https://www.bookstackapp.com/docs/admin/backup-restore).</p>

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:

```php
cd /var/www/bookstack/
sudo git pull origin release
sudo composer install --no-dev
sudo php artisan migrate
```

- Line 2 will update the repository that was created in the installation.
- Line 3 will install the PHP dependencies using `composer`.
- Line 4 will then update the database with any required changes.

In addition, Clearing the system caches is also recommended:

```bash
sudo php artisan cache:clear
sudo php artisan config:clear
sudo php artisan view:clear0
```

Check the below [Version Specific Instructions](https://www.bookstackapp.com/docs/admin/updates/#version-specific-instructions) list for the version you are updating to for any additional instructions.

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](https://www.bookstackapp.com/docs/admin/filesystem-permissions/).