How to Configure Automatic Repository Updating

Introduction

This guide explains how to set up automatic updating of repositories in Easy8. Because repository clients like GitHub, GitLab, or SVN are separate from Easy8, new commits are not reflected unless they are fetched. Webhooks allow repositories to notify Easy8 when new commits are available.

Target Audience

• Administrator

Prerequisites

Before starting, ensure you have:

• Administrator access to Easy8
• Access to your Git or SVN repository client (e.g., GitHub, GitLab, TortoiseSVN)
• An internet-accessible Easy8 instance (e.g., https://easyredmine.company.com)

How to Configure Automatic Repository Updating

Step 1: Enable Webservice in Easy8

1. Go to Administration → Settings → Git Integration
2. Enable the checkbox: Enable WS for repository management
3. Generate an API key
4. Click Save

Step 2: Add Webhook in Your Repository Client

Now, go to your Git or SVN client and add a webhook with the appropriate URL. Use your actual Easy8 domain and API key.

Git Webhook URLs

• Fetch all repositories:
  https://easyredmine.company.com/sys/git_fetcher?key=[API_key]&fetch_all=1
• Fetch all repositories on a specific project (use internal project ID):
  https://easyredmine.company.com/sys/git_fetcher?key=[API_key]&project_id=1234&fetch_all=1
• Simple fetch (no filtering):
  https://easyredmine.company.com/sys/git_fetcher

⚠ Use the internal project ID (numeric), not the project identifier (text).

SVN Webhook URLs

• Fetch all repositories:
  https://easyredmine.company.com/sys/fetch_changesets?key=[API_key]
• Simple fetch:
  https://easyredmine.company.com/sys/fetch_changesets

Depending on the SCM client, the API key may be included in the URL or in a separate field.

Step 3: Save and Test the Webhook

Save the webhook configuration in your repository client. Commit a change and verify that the commit appears in Easy8 under the project’s Repository tab.

If everything is set correctly, new commits will be fetched automatically and appear in the repository view.

Notes

• This setup is required after installation or upgrading from Redmine
• Webhook setup varies depending on your SCM client (GitHub, GitLab, Bitbucket, SVN, etc.)
• This is not required for repositories configured to fetch on view (manual fetching)

Conclusion

You have now set up automatic repository updates using webhooks. This ensures Easy8 stays up-to-date with the latest commits from your Git or SVN repositories, improving tracking and collaboration.

Related Topics and Further Reading

• Easy8 Documentation
• SCM provider documentation (e.g., GitHub Webhooks, GitLab Webhooks, SVN Hook Scripts)