Introduction
This guide will show you how to connect your Easy8 application with a GitLab instance. This connection enables automatic syncing of commits, merge requests, and test data from GitLab into Easy8. By following these steps, you’ll ensure a smooth integration between both tools.
Target Audience
- Administrator
Prerequisites
- Administrator access in Easy8
- A GitLab user account with permission to access desired repositories
- A personal access token from GitLab with full permissions
How to Connect Easy8 with GitLab
Step 1: Generate a Personal Access Token in GitLab
- Select a GitLab user to act as the integration point (e.g.
er_integrator) - Go to that user’s profile
- Navigate to Access Tokens
- Enable all permissions and create a new token
- Copy the generated token for use in Easy8
Tip: You may use a special user account that is not actively used by anyone for more secure integration management.
Step 2: Enter Connection Details in Easy8
- In Easy8, go to Administration → Git Integration
- Click on Find Available Integrations → Configure
- Enter a name for the connection
- Insert the GitLab instance URL (e.g., for cloud use
https://gitlab.com/without any sub-URL) - Paste the previously generated access token
- Click Save
That’s it! Your connection is now complete.
Easy8 will now:
- Fetch all projects the GitLab user is a member of
- Automatically create webhooks in GitLab repositories to send data to Easy8
Troubleshooting
Problem A: No Repositories Found
If no repositories appear in Easy8 after connection:
- Go to Administration → Git Integration → Configured integrations
- Click the integration name
- In the side menu, select Import
- Choose a group:
- For self-hosted GitLab: the whole instance appears as a group
- For cloud GitLab: search for your group (autocomplete supported)
- Select found repositories and click Import
Problem B: Repositories Found, But Data Not Synced
If commits, merge requests, or tests are missing:
- In GitLab, check if webhooks exist under Project → Settings → Webhooks
- If not, return to Easy8:
- Go to Administration → Git Integration → Configured integrations
- Click the integration name
- Go to Repositories
- Select one repository and click Register all integrations
This will manually create the webhook in GitLab with the correct configuration.
Conclusion
You have successfully connected Easy8 with GitLab. If issues arise, you can manually import repositories or create webhooks to restore synchronization.
