This page walks you through setting up TestFairy Connect on a Windows server, and hook it onto a Team Foundation Server.

The steps below will guide you through installing and configuring your TestFairy Connect environment:

Step 1: Install the required software

TestFairy Connect is written in nodejs. You will also need the TFS Power Tools, which are available for free download.

Step 2: Configure config.json file

TestFairy Connect's configuration file is a simple json file you can open any text editor (like Notepad) to update the settings.

  • Create a folder named .testfairy-connect in your user's home directory (for example: /Users/GilM/.testfairy-connect)
  • Paste the same configuration file from into .testfairy-connect\config.json
  • Edit the config.json file and update it to your settings. Please refer to Configuring TFS for more information on this subject.

Step 3: Start the service

After installing and configuring the service, it is time to start the service. You can start TestFairy Connect either manually in a Powershell, or as a Windows Service.

  • Open Windows Powertools or Terminal in the folder where you unpacked the zip file, and run:

node node_modules\testfairy-connect\service.js

If all the configuration are correct, you will see a "TestFairy Connect is ready" log. If you have an error, please follow the on-screen instructions.


You now have TestFairy Connect installed and configured, behind your firewall, to work with your Team Foundation Server service.