1. Open a browser and login to GitHub.
2. Browse to your avatar in the top right corner of the screen, then click on Settings.
3. Click on the menu item labelled Developer Settings.
4. Click on the menu item labelled Personal Access Tokens.
5. On this page, select Generate new token.
6. Enter a token description so you can remember what this connection is.
7. Check the following boxes:
8. Click Generate Token at the bottom of the page.
9. Copy the token which was generated (it is in green highlight).
10. In a 2nd browser window, open Nucleus and browse to Project Administration > Connectors.
11. Under the Issue Trackers section, click the GitHub icon.
6. In the Setup GitHub Connector popup, complete the following fields:
- Github URL: Enter the URL to the api of your Github instance
- Repo: Enter in the project name for which this connector is set up, including the owner. For example, rampant/demo
- Username: Enter the username you use to log into Github
- Token: Enter the token which was generated in the Github console (the one copied to your clipboard)
- Labels: This is an optional label that shows up in Github issues so you know where the issue came from.
7. Click the "Save Connection" button and wait for the Success message.
8. Click the "Verify Connection" button. You will be a message to notify you that the connection test was successful. Your connector is now setup properly.
9. Optional: Select a user from the Default Assignee dropdown menu in order to have that user be the default user when manually assigning issues so you don't have to select from the dropdown every time.
10. If you selected a default assignee, click Save Changes.
10. Close the popup window.