To get started with Haystack, you simply have to integrate us with Github, Gitlab, or Bitbucket.

Before getting into how to install, I'm sure you have some questions. We've taken the liberty of writing up the most common questions we get:

What permissions do you need?

For Haystack to provide meaningful insights, it needs read-access to the git repositories you would like to include. See the full list of permissions here.

What data do you pull?

Haystack uses only uses metadata (messages, timestamps, status, tags) on pull requests and commits.

Do you store or read source code?

Haystack does NOT read, store, or persist source code.

Can I see your security and privacy policies?

Of course. Here are the links to our security and privacy policies.

Step 1: Navigate to our onboarding page

You should see a simple page with an an option to select your organizations Git tooling. We support Github, Gitlab & Bitbucket

Step 2: Click the connect button

In this example, we will run you through a Github example.

Step 3: Select A Github Account

Select which Github account to install Haystack. Select the organization that your team actively works on.

Note: We require active Github organizations and do not accept inactive or personal Github accounts.

Step 4: Select Repositories

Select which repositories to use. These repositories will be granted read-only access to Haystack. You can select either "All Repositories" or select which specific repositories to include.

Note: If you select specific repositories, you will have to repeat this step for newly created repositories.

Step 5: You're Done!

That's it!

Now that you've installed our Github Application, your account will begin processing. Due to Github API limitations, this process may take up to 24 hours.

You'll receive an email once your account has completed processing.