How to Set Up Global Repository

Introduction

This guide will show you how to configure the global repository settings in Easy8. These settings let you manage how source control systems (SCM) interact with tasks, commits, and time tracking across your projects.

Target Audience

• Administrator

Prerequisites

Before starting, ensure you have:

• Administrator rights in Easy8
• A supported SCM client (e.g., Git) installed on the server
• Access to the Global menu in Easy8

After changing configuration files, restart the application.

How to Set Up Global Repository

Step 1: Access Repository Settings

1. Go to the Global menu
2. Navigate to Administration → Settings → Repository

Step 2: Configure Each Setting

Enabled SCM

• Select the SCM clients you want to enable (e.g., Git, SVN)
• Green icon: Installed
• Red icon: Not installed

Always confirm that the client is installed on your server before proceeding.

Fetch Commits Automatically

Enable this to fetch new commits automatically when a repository is viewed by a user.

Enable WS for Repository Management

Activate this to allow automatic pull of revisions from the original repository. Ensure the webservice is also enabled on the original repository.

Referencing Keywords

Add keywords that will link commits to tasks.
Example: refs, see, related to

Fixing Keywords

Add keywords that will update task status or progress via commit messages.
Example: fixes, closes, resolves

Assignee

Choose the default assignee for a task when a fixing keyword is used in a commit.

Applied Tasks

Define the task status to be applied when a fixing keyword is used.

% Done

Set the default percentage of completion when a fixing keyword is used.

Allow Cross-Project Task Reference and Fixing

Enable this if you want to reference or close tasks from other projects directly in commit messages.

Enable Time Logging

Activate to log time via commit messages.

Activity for Logged Time

Select the activity to be used for time entries made via commit messages.

Step 3: Save Your Configuration

Click the green "Save" button at the bottom of the settings page.

Step 4: (Optional) Edit Configuration File

You can further customize SCM commands by editing:

config/configuration.yml

Restart the application after modifying this file.

Conclusion

You’ve now configured the global repository settings in Easy8. These settings help integrate SCM clients with project management features such as task updates, time logging, and cross-project commit references.

Related Topics and Further Reading

• Easy8 Documentation
• SCM client documentation (e.g., Git, Subversion)
• Easy8 Webservice Configuration Guide