How to Activate Repository on a Project

Introduction

This guide will show you how to activate and configure a repository for a specific project in Easy8. Once activated, you can integrate Git, SVN, or other supported SCM systems and view project files directly in the application.

Target Audience

Administrator

Prerequisites

Before starting, ensure you have:

Administrator or manager rights on the target project
A supported SCM repository (e.g., Git, Subversion)
The necessary credentials or access URL for the repository

Most Git servers require authorization (token or SSH key). Ask Easy Software for a public key if needed.

How to Activate and Configure a Project Repository

Step 1: Enable the Repository Module

Open the project in Easy8
Go to Settings → Modules
Check the box next to Repository
Click Save

After saving, the Repository tab will appear in the project’s top menu.

Step 2: Open Repository Settings

Click the Repository tab
A configuration screen appears with default/global settings
You can change how commit messages are fetched or leave it unchanged to apply global settings

Step 3: Create a New Repository

Click the New repository button to start creating one.

You will need to fill in the following (depending on the SCM type):

SCM type (e.g., Git, SVN, Mercurial, CVS, Bazaar, Darcs)
Main repository (check this if it is the primary one for the project)
Identifier (optional, for naming purposes)
URL or path to repository
Encoding (if needed)
Login credentials (if required)

For Git-based SCMs, you can use token-based URL authentication:

https://user:repoclienttoken@url/repo.git

Instead of using plain user/password.

When ready, click Create.

Step 4: Manage Repositories

After creation, the project repository page will show a list of all connected repositories.

On the right side of each repository entry, you can:

Users: Map repository usernames to Redmine users (auto-mapping is available)
Edit: Update repository settings
Delete: Remove the repository

Step 5: Confirm Repository Access

If configured correctly, you'll see files and folders from the repository directly in Easy8 under the Repository tab.

This confirms the repository is successfully linked and readable.

Conclusion

You’ve now activated and connected a repository to your project in Easy8. This allows direct access to source files, commit history, and user mapping for seamless task tracking and version control integration.