What is TestFairy Connect?
TestFairy Connect is proxy server installed on-premise, designed to help companies connect their bug tracking systems running behind firewall (JIRA Server), with the TestFairy cloud.
How does it work?
The key part of TestFairy Connect is the agent service that runs on a system, within your firewall, connecting to TestFairy's web app and to your bug tracking system.
How to Install TestFairy Connect (video tutorial)
- Node.js 10+
- Git 1.7+
Installation is done via npm. Please run the following command in any folder for your TestFairy Connect installation:
sudo npm install -g git+https://github.com/testfairy/testfairy-connect.git
To configure TestFairy Connect, run the following line and follow the on-screen instructions:
testfairy-connect configure [-f /path/to/config.json]
You'll need the following data:
- TestFairy API key (found at https://[your-subdomain].testfairy.com/settings/api-key/
- The URL to your bug system.
- In the case of a JIRA basic authentication - valid credentials for a bug system user.
- In the case of a JIRA oauth authentication - admin access to JIRA/the ability to manage Application Links (as described in the configuration wizard script).
By default, your configuration file
config.json is located in
.testfairy-connect under the running user's home directory:
If the optional
-f parameter is omitted, TestFairy Connect will use the default location.
Running TestFairy Connect
To start the TestFairy Connect agent, use the following command:
testfairy-connect start [-f /path/to/config.json]
If the optional
-f parameter is omitted, TestFairy Connect will use the default location: /path/to/user/home/.testfairy-connect/config.json
The agent is now running in the background, and will keep running even when the terminal connection closes.
Stop TestFairy Connect
To stop the TestFairy Connect agent, use the following command:
You now have TestFairy Connect installed.
Please visit Bug System Settings and select "TestFairy Connect".
Last updated on 2019-08-05