Updating FreeScout

• Method 1. Update from web interface (recommended)
• Method 2. Update using console script
• Method 3. Update using GIT
• Method 4. Manual updating
• Troubleshooting

---

Before apdating the app make sure to backup application files and database.

---

Method 1. Update from web interface

Open FreeScout and go to Manage » System » Status. In App Version section click Check for updates and follow instructions:

Updating process may take several minutes, do not close browser window until it finishes or shows an error.

If self-updater script fails:

• Try to update again.
• If still does not work, switch to another update methods.

Method 2. Update using console script

This method requires SSH console and GIT.

1. Go to the root of your FreeScout application.
2. Run update script:

tools/update.sh

3. Follow instructions.

Method 3. Update using GIT

This method requires SSH console and GIT.

1. Pull updates from GitHub:

git pull

2. Run the following console command:

php artisan freescout:after-app-update

Method 4. Manual updating

Use this method only if you can not use console or GIT.

1. Open https://example.com/tools.php

2. Enter APP_KEY from your .env file and click Update App button.
3. Open and check application.

Troubleshooting

If self-updater script hits your hosting's PHP memory size limit or `PHP max execution time

• Try to update again.
• If still does not work, switch to another update methods.

Permission denied when writing to some file

Check permissions section in "Manage > System > Status".

See https://github.com/freescout-helpdesk/freescout/wiki/Installation-Guide#if-you-are-receiving-failed-to-open-stream-error-message-upon-logging-in