Installation requirements

TestRail is a web application that is installed directly on your web or application server. It uses a database (SQL Server or MySQL) to store the application data and requires a working PHP environment to run. Please see below for the exact server requirements and supported versions.

info Please note: As of TestRail 7.0, PHP 7.2.x is no longer supported.

Windows Server

  • Operating System: Windows Server, 2012/2012 R2, 2016, or 2019
  • Database: 2012, 2014, 2016 with Mixed Mode Authentication, 2017, or 2019. (MySQL is not supported in a Windows environment)
  • Web server: IIS with FastCGI / PHP integration
  • PHP: 7.3 or 7.4 (with curl, mbstring, zip, json and sqlsrv/mysql extensions)
  • ionCube PHP Loader extension (learn more)

Unix/Linux Server

  • Operating System: We test TestRail with various Linux distributions, but any standard Unix-based server operating system with Apache, MySQL, and PHP support will work. We recommend Ubuntu Server LTS versions.
  • Database: MySQL 5.7, 8.0 or MariaDB 10.1 or later
  • Web server: Apache with mod_php or equivalent
  • PHP: 7.3 – 7.4 (with curl, mbstring, zip, json and mysql extensions)
  • ionCube PHP Loader extension (learn more)

Web browsers

  • Microsoft Edge (recent versions)
  • Firefox (recent versions)
  • Chrome, Safari, Webkit (recent versions)

Hardware requirements

We don’t have any specific minimum hardware requirements or specifications, as this depends on the number of users you have, planned usage and other factors. For example, teams that upload a lot of large videos to TestRail would need more disk space. Likewise, to integrate a massive test automation suite, then optimizing the system for fast database/disk performance would be more important.

We still get the hardware requirement request often, so we want to provide at least some starting point for your own planning. In general TestRail doesn’t require a lot of resources for a typical usage scenario, even with very large teams. So a reasonable modern system will work very well. The below details provide a good starting point for your planning. We also have additional optimization tips for large installations.

  • CPU & Cores: reasonable modern CPU with multiple cores
  • Memory: 4GB+ (Linux) or 6GB+ (Windows Server)
  • Disk/IO performance: server-grade disk/IO sub system recommended
  • Disk space: 200MB+ per user, plus system etc. (e.g. 20-40GB+ for overall machine)
  • Virtualization supported: yes, with server-grade VM product