TestRail 9.8.1.1506 Docker Image

Default release track date: 26-Dec-2025

We’re excited to announce the release of TestRail 9.8.1, introducing one of the most requested usability upgrades - the Rich Text Editor. This release brings a faster, cleaner, and more intuitive text editing experience across the platform, while maintaining full markdown compatibility.

On top of the above, this release also improves platform stability and performance across core workflows, especially in report generation, chart visualization, and Jira integration, helping teams work with greater confidence and less friction in their daily workflows.

If you’ve experienced failed reports, missing charts, or problems pasting Jira issues into defect fields, this update should bring immediate and noticeable improvements.

Follow the Docker installation instructions here: TestRail 9.8.1 on Docker

Please note that our recommended upgrade path is via TestRail 8.0.4. If you’re still running TestRail 7.0 or below, you should follow the path below:

Once the upgrade is complete, you must open _config/config.php in your Docker files folder, and add new line with: 

define('TR_CHROME_PATH', '/usr/bin/chrome-headless-shell-linux64/chrome-headless-shell');

📝 Rich Text Editing 

Modern, Intuitive, and Backward Compatible

TestRail 9.8 introduces a modern Rich Text Editor across all major text fields. The new editor replaces markdown-only formatting with a professional WYSIWYG (What You See Is What You Get) experience, making test authoring more efficient and visually consistent.

  • Enhanced text authoring: bold, italic, underline, colors, lists, links, tables, and more, all accessible from an intuitive toolbar.
  • Rich media support: insert images and attachments directly into text fields with drag-and-drop capability.
  • Streamlined experience: clean design, instant formatting preview, and contextual quick-insert options for faster editing.
  • Markdown compatibility preserved and upgraded: all existing test cases using markdown remain fully supported and upgraded to the new formatting.
  • Consistency across TestRail: available by default in key fields such as test cases, steps, expected results, and descriptions.

This enhancement delivers faster test case creation, improved readability, and a more professional documentation experience for QA teams of any size.

New toolbar
New toolbar
👉 Learn more about the Editor Formatting Reference.

🔗 Integration Cards Updates

We’ve added new cards under Administration > Integration > Integrations page, for quicker access to documentation and setup instructions.

These include:

💻 TestRail CLI 1.12.5

The latest version of the TestRail CLI is now available with new capabilities:

  • You can now use the new --parallel-pagination option when importing large test result files for improved performance and more reliable error handling.
  • This release also includes the following fixes:

    • The label add command now correctly adds labels to projects.
    • Errors from failed attachment uploads (e.g., due to large file size) are now properly shown in the standard output.
    • Test cases are no longer deleted from existing test runs with configurations in test plans.
👉 Learn more in the TestRail CLI documentation.

🐞 Fixes and Improvements (11)

  • TR-11211: Fixed an issue where memory exhaustion caused crashes during certain operations.
  • TR-12512: Fixed “Out of Memory” errors message issues.
  • TR-12562: Resolved an issue where the "Report Details > Chart" section displayed "No data to display" incorrectly.
  • TR-14897: Reports with multi-select custom fields failing to generate
  • TR-15065: Addressed performance issues that caused some reports to take longer or fail to generate.
  • TR-16114: Fixed missing bar charts in the Property Distribution and Workload Summary reports.
  • TR-16200: Error when importing CSV files
  • TR-16577: “Invalid filter definition” error when filtering tests by labels
  • TR-16687: Defects & References field - Copy/ paste and Count functionalities not working as expected.
  • TR-16785: Test steps being deleted after entering "Edit" mode
  • TR-16822: Fixed a bug where pasted values in the Defects/References fields were not saved correctly in Jira-integrated instances.

📌 Cassandra Deprecation Enforcement

Starting with TestRail 9.5 Server, Cassandra is officially deprecated and enforcement is in place.:

  • Admins must first run the Cassandra deprecation script in version 9.4.1 before upgrading to 9.5.

  • If the script has not been executed, the upgrade to 9.5 will be blocked and a  warning message will be displayed  during the upgrade process.

👉 Please check our Cassandra Deprecation documentation.

 

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