This topic explains how to upgrade an existing TestRail installation to a new version. 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, and especially before upgrading to a newer version.
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, but not all, TestRail upgrades also need to upgrade the TestRail database. If a database upgrade is required, TestRail will automatically redirect you to the database upgrade screen when you access TestRail with your web browser. Only administrators can upgrade the database and all other users won't be able to access TestRail until the database upgrade has been completed.
After completing the database upgrade (if a database upgrade was required by the new TestRail version you just installed), your updated TestRail installation is ready to use.
Starting with TestRail 4.2, it's also supported to finish the upgrade via the command-line instead of stepping through the upgrade wizard with a browser. To do this, open a command prompt or terminal, go to TestRail's installation directory and execute:
$ php run.php update