TestOptimal Installation

This document provides the instructions to install & start TestOptimal Server.


  • JDK 17 or later
  • OS: Windows, Mac, Linux.
  • Memory: at least 4GB
  • Disk Space (free): at least 2GB.
  • Modern browser (Firefox, Chrome, Edge, Safari)

Installing TestOptimal Server/IDE

Choose one of the installation options below. After completing the installation, open TestOptimal IDE with a browser at: http://localhost:8888. The community license is pre-instaplled. You just need to accept License Agreement and set up the login account to access your server.

Check out this video: Download & Install.

Windows Installation

  • run (double-click) downloaded file TestOptimal_Setup.exe and follow the instruction
  • alternatively if you've downloaded the zip file instead, just unzip the zip file and run (double-click) startTestOptimalServer.bat

Mac / Linux Installation

  • unzip TestOptimal_'ver'_mac.zip to local disk (e.g. apps/TestOptimal.app).
  • Install GraphViz (you may perform this step later):
 ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
 brew install graphviz
  • start server by running startTestOptimalServer.sh


  • run following docker command to start TestOptimal server:
    docker run -p 8888:8888 testoptimal/mbt:7.0.3


Browser Setup

TestOptimal utilizes Selenium/WebDriver to perform browser automation. The system will automatically download the appropriate driver when it's needed and thus internet is required.

Alternatively, you may copy the required browser driver into the expected location ahead of time to remove this dependency. Check SvrLog file for the location of the driver files: e.g.

 2020-05-18 13:44:40 [INFO] loading chrome driver from C:\Users\myAccount\.m2\repository\webdriver\chromedriver\win32\80.0.3987.106\chromedriver.exe

If you are performing AUT testing on Safari browser, you will need to enable automation on Safari browser by running the following command once:

 safaridriver --enable


Refer to Server Configuration to customize your installation.