Upgrade Guide

If you made any code changes, it is highly recommended to backup the root folder of your project and the database before the update.

Update Steps

The update process is pretty much straightforward, you will have to upload the new files and overwrite existing ones, except 3 files: public_html/.htaccess, public_html/.env and public_html/public/.htaccess and here is how you can do it step by step:

  1. Login into your control panel and open file manager, navigate to the root folder of your project.
  2. Open public directory and copy the .htaccess file to .htaccess.current
  3. Go back to the root directory and copy .env file which exists on the root directory of your project to .env.current.
  4. Copy .htaccess file - found in the root directory - to .htaccess.current
  5. Upload the public_html.zip file to your server, and then extract it.
  6. After extracting the files, .env and .htaccess files will be overwritten.
  7. Delete both .env and .htaccess files.
  8. Copy .env.current file to .env and .htaccess.current to .htaccess
  9. Open public directory, and copy .htaccess.current to .htaccess
  10. After the update is completed log in to the dashboard area from your super admin account and go to System > Cache and clear both Configuration cache and Views cache.
  11. Refresh the page and then go to System > Status. You should see your application updated to the latest version.

For Docker Users

Run docker compose up --force-recreate in order to force Laravel's scheduler to see the code changes.

.env File Not Found?

In cPanel, the .env file might be hidden. Go to settings (from the top right corner of the screen) and then unhide files in the public_html folder.