Starting with version 9.8.x TestRail uses a Rich Text Editor component which requires an annual license key update. If your instance has not been updated by end of June 2026, users will see a license warning message when opening a page that contains a rich text field (see below).
To update your license key, follow the steps according to your installation type.
Bare Metal (Linux)
- Download the patch files - link.
- Locate the folder in the patch archive that matches your TestRail version (e.g., froala-patches\testrail-10.3.1\).
-
Copy the patched JS files to your TestRail installation's js\bundle directory:
cp froala-patches/testrail-<version>/testrail/js/bundle/application.search.js <TestRail installation path>/js/bundle/ cp froala-patches/testrail-<version>/testrail/js/bundle/application-entrypoint.js <TestRail installation path>/js/bundle/ -
Set the correct file ownership:
chown www-data:www-data <TestRail installation path>/js/bundle/application.search.js chown www-data:www-data <TestRail installation path>/js/bundle/application-entrypoint.js
Bare Metal (Windows)
- Download the patch files - link.
- Locate the folder in the patch archive that matches your TestRail version (e.g. froala-patches\testrail-10.3.1\).
- Copy the patched JS files to your TestRail installation's js\bundle directory, replacing the existing files.
Docker
- Download the patch files - link.
-
Identify your TestRail container name:
docker ps -
Copy the patched files into the container. Note: use . (dot) not * (asterisk) at the end of the source path:
docker cp froala-patches/testrail-<version>/testrail/js/bundle/. <container-name>:/var/www/testrail/js/bundle -
Set the correct file ownership:
docker exec -it <container-name> chown www-data:www-data \ /var/www/testrail/js/bundle/application.search.js \ /var/www/testrail/js/bundle/application-entrypoint.js
Verify the patch
Log in to TestRail and open any page containing a rich text editor field. The license key warning should no longer be visible.