Join 34,000+ subscribers and receive articles from our blog about software quality, testing, QA and security.

TestRail upgrading database?


Please, Could someone explain to me how when doing a TestRail upgrade, the TestRail installation wizard when need be, does the database update? I am about to do a TestRail upgrade from Ver. 4 to Ver. 5, and I want to know how everything pieces together in an upgrade.

Thanks in advance



I can’t imagine it is anything more than a db script included in the package and if included - it is run as part of the installation.


Hello Jesse,

Thanks for your posting! You can find the upgrade documentation here:

You would basically need to copy the TestRail files from the new version into your existing TestRail installation directory (thus replacing all files and adding some new ones). When you then access TestRail with your browser and TestRail detects that a database update is necessary (which it is from TR 4 to 5), TestRail would automatically show an upgrade wizard to complete the update. It’s basically a two step wizard that automatically detects your current TestRail database version and then applies all updates automatically.

We always recommend making a fresh backup before updating to a new TestRail version just in case but the upgrade will also mention this.

There’s also a command line version of the updater which is useful to automate the update or for large TestRail installations/databases:

I hope this helps and please let me know in case anything is unclear.