Upgrading TestRail from 8.0.1 to 8.0.4 in Windows


TestRail 8.0.4 is available for all Server customers. Customers who wish to upgrade to TestRail 8.0.4 can download the installation files from the Customer Portal.

Below, you will find information on how to upgrade an existing TestRail installation to the new version (8.0.1 to 8.0.4). Please follow these steps to upgrade your TestRail installation.


It is strongly recommended to make a backup of your TestRail installation files and TestRail database before upgrading to a newer version. In case there’s a problem with the upgrade, a backup is the only way to roll back the changes and revert to your previous (working) installation. We recommend making backups of your TestRail installation and database regularly, especially before upgrading to a newer version.


Before proceeding with an upgrade to TestRail, please review the requirements documentation and operating specific instructions (Windows/Linux). Software dependencies such as PHP and SQL can change over time, so it is important to review these requirements prior to updating your TestRail software.

Replace installation files

To upgrade your TestRail installation, upload and extract the TestRail installation files to your web server and copy the files of the new TestRail version over your existing installation files. You can just replace all files, as files that are unique to your installation (e.g. the config.php file) aren’t part of the installation archive.

Some web server configurations can prevent files from being overridden while the web server is active. You need to stop the web server before replacing TestRail’s installation files. This happens mainly with Windows/IIS systems, so if you have upgrade issues, try stopping the web server and overriding the files again.

Once the files have been replaced, the instance has been upgraded. Now, you must:

  1. Navigate inside the TestRail root directory where run.php file is located
  2. Run php run.php update

Once the above has been done, you can Log into the instance via a web browser (usually ‘http://localhost/testrail/’ or something similar) to confirm a successful upgrade.

Was this article helpful?
0 out of 0 found this helpful