Installing Delphi and DUnitX Testing Framework


A 30 day free trial of Embarcadero's RAD Studio or Delphi may be downloaded from here. Alternatively, a free Starter Edition version is also available. Follow installation instructions included with the product.

Non-Windows based Operating Systems

Delphi will not run in a non-Windows based operating system. However, it is possible to run Delphi within a virtual machine that is hosting Windows.

Installing DUnitX Test Framework

DUnitX comes installed in Delphi version XE8 and up with an exception for the Starter Edition of Delphi.

With Delphi successfully installed, and working correctly, please follow these steps for retrieving and installing DUnitX if you find that your installation of Delphi is lacking the DUnitX framework.

  • DUnitX is an open source project by VSoftTechnologies. The DUnitX GitHub repo is available here.
  • It is best to fork the repo and then clone or otherwise download the fork to your local machine.
  • Step-by-step instructions on how to install DUnitX into Delphi have been posted by Vincent Parrett in a blog post located here.
  • The Starter Edition of Delphi doesn't allow the use of project experts. DUnitX comes with an expert which will aid the student in creating a new DUnitX based project. The expert creates the project's .DPR file. The exercises in this track all include the .DPR file making the expert not necessary. DUnitX otherwise has no issues with projects created in Delphi versions starting with XE all the way up to and including the Starter Edition of Berlin.

Delphi Configuration for DUnitX

If you had to install DUnitX because your installation didn't already come with it then please follow the following illustrated steps to make the necessary configuration changes to Delphi in order for it to locate your installation of DUnitX.

Note: it is assumed that you have completed the installation of Delphi by this point.

  • Start Delphi. If your installation is new you will most likely end up at a Welcome Page similar to this.

Welcome Page

  • Find and click Tools along the top menu.


  • Click Options.


  • Along the left side of the Options screen find and click on Environment Variables.

Options Screen Environment Variables

  • Click the New button located in the User overrides group

Click New

  • A New User Variable window should appear that contains two fields. In the top field enter DUNITX for the Variable Name. In the bottom field enter the complete path to your copy of DUnitX, for example mine is C:\Program Files\Embarcadero\Studio\18.0\source\DUnitX. Click the Ok button to then close this window.

New User Variable

  • Locate and click on Library along the left side of the Options screen.


  • Click the ... button associated with the Library path in the Directories group


  • In the Directories window enter the variable name that you created a few steps ago. The entry should appear like this $(DUNITX)


  • Click the Add button to add this new item to the list.

  • Click the Ok button to store the change.


  • Finally, click the Ok button on the Options window to save all the changes.

Delphi will now be able to locate units that pertain to the DUnitX testing framework library.

Note: It is assumed that Delphi versions XE and higher are being utilized by the student.

Help us explain this better! File a GitHub issue at if you have suggestions, or submit a patch with improvements to the file.