How to Connect Easy8 with GitHub

Introduction

This guide will show you how to connect your Easy8 application with a GitHub instance. This integration enables Easy8 to display repositories, pull requests, commits, and test data from GitHub for better tracking and reporting.

By following these steps, you’ll be able to create a secure and working GitHub connection in Easy8.

Target Audience

• Administrator

Prerequisites

• Administrator access in Easy8
• A GitHub user account with access to the desired repositories
• Git Integration (Easy GIT) installed and active
• Ability to generate a personal access token on GitHub with the required scopes

How to Connect Easy8 with GitHub

Step 1: Generate a Personal Access Token in GitHub

1. Log in to GitHub with the user account that will be used for integration (e.g. er_integrator)
2. Click on the avatar in the top-right corner → Settings
3. Go to Developer settings → Personal access tokens
4. Click Generate new token
5. Select the following scopes:
   • repo – Full control of private repositories
   • admin:repo_hook – Full control of repository hooks
   • user – Update ALL user data
6. Click Generate and copy the token

Step 2: Enter Connection Details in Easy8

1. In Easy8, go to Administration → Git Integration
2. Click on Find Available Integrations → Add
3. Enter:
   • A name for the connection
   • The GitHub URL (e.g. https://github.com/ without the sub-directory)
   • The personal access token you generated
4. Click Save

Note: The integration respects GitHub permissions. Only repositories accessible to the token user will be visible.

Once saved, the connection is live. Easy8 will automatically:

• Fetch all repositories the GitHub user has access to
• Create webhooks in each repository to receive updates about commits, pull requests, and test results

Troubleshooting

Problem A: No Repositories Found

1. Go to Administration → Git Integration → Configured Integrations
2. Click on the integration name
3. In the side menu, select Add Repository
4. Search for the repository name
5. Once selected, remaining fields auto-fill
6. Click Save

Problem B: Repositories Found, But Data Not Synced

1. Go to your GitHub repository → Settings → Webhooks
2. Check if a webhook pointing to your Easy8 instance exists

If missing:

• Go to Administration → Git Integration → Configured Integrations
• Click on the integration name
• Select Repositories
• Click on the repository name
• Click Register all integrations to recreate webhooks

If a webhook exists but shows an error, review the error message and fix the issue accordingly.

Conclusion

You’ve successfully connected Easy8 with GitHub. This setup enables automated data sync from GitHub repositories for improved project visibility and collaboration within Easy8.

Related Topics and Further Reading

• Easy8 GitHub Integration
• How to Work with GitHub Repositories
• Easy8 Documentation
• Easy Project Documentation