Starting to use Crucible

Still need help?

The Atlassian Community is here for you.

Ask the community

This page introduces the basics of using Crucible. By the end, you'll know how to:

For more information, see the Crucible user's guide.


We're assuming that:

Add a repository

First up we're going to add a repository to Crucible.

Go to the Admin area by clicking on the 'cog' at the top right and choosing Administration:

Click Add repository in the Repositories listing of the Administration area:

Choose the repository type and fill in the name and description.

In the repository configuration put the location of your repository. Fill in the authentication details if necessary.


Finally, indicate whether or not you would like diff indexing turned on and if the repository should be indexed right away, then click Add to finish the process.

Your repository is now created in Crucible and the indexing should have started.

Create a project in Crucible

Crucible comes with a default project, with the key CR, but you will will probably want to create your own projects to contain your reviews. This is achieved in a couple of steps.

Click Add a new project in the Projects listing of the Administration area.

Fill in the form with the default settings for the project and hit Save.

You'll see your new project in the Projects listing.

Create a review

Now that you have your own project you can create reviews in it.

Of course, you'll need to be logged in to create a review.

From the header, click Create review to open the review creation form:

Choose the project in which you want to create the review:

In the next screen, click Browse changesets to see the list of changesets available for the review.

Select the changesets that you want to be reviewed, then click Edit Details:

Now add reviewers and update the review information, then click Start Review

The review is now created and the reviewers will have been notified that a review is pending.

In order to close a review, when you are the moderator, you need to click on Summarize at the top right and then close the review from the dialog:

Last modified on Sep 12, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.