Skip to content
This documentation applies to Codacy Self-hosted v3.4.0

For the latest updates and improvements, see the latest Cloud documentation instead.

Getting started with Codacy

Codacy automatically analyzes your source code and identifies issues as you go, helping you develop software more efficiently with fewer issues down the line. Through static code review analysis, Codacy notifies you of security issues, code coverage, code duplication, and code complexity in every commit and pull request.

To get started, head to and click Get started.

1. Sign up

Sign up with a Git provider such as GitHub, GitLab, or Bitbucket. This links your Codacy user with your Git provider user, making it easier to add repositories to Codacy and invite your teammates.

Codacy will request access to your Git provider during the authorization flow. Check the permissions that Codacy requires and why. Codacy will also ask you to fill in a few details about your company so we know a bit more about your use case.

2. Choose an organization

Now, you'll need to add or join the organizations that contain your repositories. The organization with the same name as your Git provider username contains your personal repositories. Read more about organizations on Codacy.

Choosing an organization

To start adding your repositories, select one of the organizations.


If you can't see the organization you're looking for, follow these troubleshooting instructions.

3. Add repositories

Next, add the repositories that you wish to analyze. Codacy begins an initial analysis as soon as you add a repository and sets everything up to ensure your next commits on that repository are analyzed.

Adding repositories


You can only add repositories on Codacy if you have the necessary permissions on your Git provider.

Click the link Go to repository to see the code quality overview of your repository as soon as the initial analysis is complete:

Repository dashboard

4. Tweak your repository settings

Check the static analysis results on the Issues page to explore the initial analysis results.

The first analysis is based on Codacy default configurations, so you should tweak and adapt the following configurations to match your preferences and specific scenario:

You're all set! 🎉

Congratulations, your new repository is ready!

Optionally, you can also:

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

We're sorry to hear that. Please let us know what we can improve:

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact

Last modified March 5, 2021