Help Index

GitHub Website

How does Testuff integrate with GitHub?

Although Testuff is a hosted service it can automatically send every reported defect to your GitHub account. You can run your manual tests with Testuff and continue to use GitHub for bug tracking.

The integration is done by the desktop client. Therefore, it should also work if you host GitHub on an internal server. Our server doesn’t need to access your bug tracker server and you don’t need to change anything in your security or firewall configuration to make it work.

How do I configure GitHub with Testuff?

  1. In Testuff, go to Settings > Bug Tracker and click the Add bug tracker link.
  2. Choose GitHub from the bug trackers combo box.
  3. Enter the URL. If installed locally it should be something like Otherwise use
  4. Set the Default Repository. Defects exported from Testuff projects that do not have a custom GitHub repository will be exported using this repository name.
  5. Click Set my GitHub user to enter your GitHub token*
  6. Hit the Test connection link to verify correct setup.
  7. You may click the Submit sample link to make sure Testuff can create bug reports in GitHub. If all goes well the new bug report should be displayed.
  8. Don’t forget to click OK to save the settings.

* Creating your GitHub token:

  • On any GitHub page, click your profile icon, then click Settings.
  • On the sidebar, click on Developer settings.
  • On the sidebar, click Personal access tokens.
  • Click Generate new token.
  • Add a token description, check the “repo” permission and generate the token.

Setting up automatic 2-way integration

Testuff supports an industry-unique option to automatically update your reported defects in Testuff, with any change made to them in your GitHub. Here’s how to set it up:

  1. Go to your GitHub and enter a repository you own.
  2. Go to Settings and click Webhooks, on the left side menu.
  3. Add a new webhook:
    • Under Payload URL enter the URL you see in Testuff Settings->Bug trackers->GitHub (under “Automatic 2-ways Integration URL” towards the bottom of the window).
    • Under Content type choose application/json.
    • You can opt to use a GitHub secret ID. If you do use the word “Testuff”.
    • Check Let me select individual events and then check Issues and Issues comments.
    • Add the webhook
  4. You’re all set to report defects from Testuff to your GitHub account, and get back automatic updates.

Can I add my labels to the bug report?

Yes. Enter the name of the label (or labels, separated by a comma) in the labels field. That’s it.

Can I associate a custom GitHub repository to a Testuff project?

Yep. If you wish to export defects from a certain Testuff project to a certain GitHub repository, follow the instructions below. Projects that do not have a custom GitHub repository set to them will use the default one from the general settings.

  1. Go to the home screen via the house icon at the top left.
  2. Click the Manage projects link and select a project by clicking on the Edit link next to it.
  3. Under the General tab, fill in the GitHub repository for this Testuff project.
  4. Click OK to save the settings.

How do I integrate my GitHub requirements with Testuff?

First, go to the Testuff project settings window and select your tracker as the requirement tool.

Then from the Requirements screen:

  1. Click on the more link, at the bottom of the screen.
  2. From the menu, select Add from GitHub.
  3. Now, enter a GitHub ID, or a few of them separated by commas.

Please contact us for any help integrating Testuff with your Github.

Help Index