How can I merge two users with different emails who in fact are one person?

Starting from Stash 2.5.0 you can use .mailmap file in the repository to do this. Changing a global .mailmap file in Git won't help (see details here). In order for the changes to take effect, the Stash administrator should disable the add-on and then enable it again.

How can I get a Community license?

Community license is free both for Stash and Awesome Graphs. To get it, please, request it from Atlassian here. To learn more about Community license, see this page.

What time zone is used for displaying statistics?

Awesome Graphs uses the time zone set for the Stash instance. If all commiters are located in the same time zone, you may want to set the time zone for Stash.

To do that, you need to:

  1. Set the -Duser.timezone parameter for JVM on the server where Stash is installed. For example, -Duser.timezone=Europe/Berlin. Read more about JVM parameters in the Atlassian JIRA documentation.
  2. Restart Stash.
  3. Make sure that the field Time Zone displays correct time in Administration - Atlassian Support Tools - System Information - Stash Information.

When does Awesome Graphs index repository data?

After Awesome Graphs is installed on Stash it starts indexing all repositories associated with it. When Awesome Graphs is updated, reinstalled or reenabled, it indexes repositories all over again.

Where does Awesome Graphs store indexed data?

In RAM. The larger is your repository, the more RAM you need for stable and fast performance. Awesome Graphs doesn't write index data to a hard drive. If a Stash server is restarted, Awesome Graphs indexes everything from scratch.

What data does Awesome Graphs index and what is indexed first?

First, the add-on indexes default branches of all repositories, then all other branches and finally all tags of all repositories.

It takes too long to index my repository. What is the problem?

On large Stash instances Awesome Graphs may need some time to index all data. In this case we recommend running Awesome Graphs on staging environment first.

Awesome Graphs is indexing data and completely loads one CPU core. Is it normal?

Yes. On large Stash instances, Awesome Graphs can load one core completely. We recommend installing it on a server with at least a dual-core CPU for better performance.

Awesome Graphs crashes Stash. What gives?

Most likely you don't have enough RAM to index all data in your repositories. Please, add more RAM to a server where Stash runs. Also, see #5 in this FAQ.

Why there's no link to Contributions from the Contributors graph?

The Contributors graph displays a link to Contribution only if a commiter is a Stash user and:

  • either their email is the same as in the Git settings,
  • or their Git username is the same as their Stash display name.

See #1 in this FAQ to learn how to merge different user names and emails for one person.

Can I select a time interval for displaying stats in Contributors shorter than one week?

No. The Contributors graph stores statistics in Sundays, therefore an interval should span a Sunday and cannot be less than one week.