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.

If you host GitHub on an internal server, the integration is done likewise. 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 and select the Bug Trackers menu option. The Bug trackers integration page will display. Click the Add bug tracker link.
  2. Choose GitHub from the Select a bug tracker 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 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?

After clicking the Customize bug tracker field button, click on the Edit link at right of Labels and you may enter the name of the label (or labels, separated by a comma) in the Manage bug tracker fields popup window.


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

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 Settings menu option at the top left of the screen.
  2. Click on Projects option and select a project by clicking on the Edit link next to it.
  3. Under General Settings section, make sure the Tracker field is set for GitHub repository and fill in the Project for this Testuff project.
  4. Click Save button to register the new settings.







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

Help Index