Table of Contents

Overview of Projects

HgLab ties related source code repositories together into projects. Projects enable you to organize and manage repositories and teams, making managing access to your repositories simple and straightforward.

Adding Projects

To add a Project, you need to have a "Project Management" permission (or be a System Administrator). Click the "+ Project" button on the Dashboard page and you'll see a dialog:

Adding Projects to HgLab
The name of the Project. This one will be prominently visible in the UI.
Start typing the name of the Project Lead.
This is a short name for the Project, which will be used instead of a (possibly) longer Name in all URLs.
A few words on what the Project is all about.
Other people get access to the Project by being members of Teams.

Activity Stream

The "Activity" page displays all the recent activity going on in this particular Project.

Activity Atom Feed

Each authenticated user can get a personalized Atom feed with all the same information that is displayed on the Project Activity Stream.

Activity Atom Feed
Note that Atom feed URL includes a Personal Token, which is unique to each and every user and cannot currently be changed. Please, do not share this URL with anybody.


Projects group together Repositories, which can be accessed by clicking the "Repositories" item in the navbar.

See Repositories for more information.


Teams allow Project Administrators to assign different Project Roles to different Users. See Teams for an in-depth discussion.


HgLab includes a full-featured project-level Wiki, backed by a Mercurial repository. See Wiki to find out more.


When you Watch a Project, receive you email notifications about everything that's going on with the Project:

Additionally, your Activity Stream on the Dashboard will also include activity from the Project.

To start Watching a Project, click the "Watch" button in the top-right corner of the page:

Watching Project


To access Project Settings, click the wrench icon in the navbar:

Accessing HgLab Administration Area

For this icon to appear, you'll need a "Project Management" permission.


Project Name
The name which is displayed in the UI. Changing the Project Name does not actually change repository URLs, so all clones remain just fine.
Project Description
Short summary on what this entire Project is about.
Public Access
Public Access grants anonymous users a read-only access to the project, allowing to browse the files and commits for the project, see reviews, approvals, discussions and to clone repositories — all without needing to log in, or have an account in HgLab.

Here Be Dragons

This is where Project Managers can actively delete a Project. Note that this deletes all Pushlog, Teams, all Discussions, but does not delete repository data from the file system.

With this feature you can link your Repositories to content that matters to you - entries in your issue tracker, build server, you name it.

To add a link, click the "+ Link" button.

Add Link Dialog
Replacement URL
The URL that will be used to create a link to your content. Reference regex capture groups from Match Regex using $1, $2, etc. syntax.
Match Regex
Custom regex that is used to extract relevant information.

For example, the Replacement URL$1 accompanied by the Match Regex (PROJ-\d+) will link your JIRA issue keys that start with PROJ-.

comments powered by Disqus

Take HgLab for a Spin

Try HgLab now. Full-featured 45-day evaluation, no credit card required.