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

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

Getting started with Codacy

Codacy automatically identifies issues through static code review analysis and notifies you on 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

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

Codacy will ask you to have access to your Git provider during the authorization flow. Check the permissions that Codacy requires and why.

2. Account details

You'll be asked to fill in a few details about your company so we know a bit more about your use case.

3. Choose an organization

Now, you'll need to join one or more organizations that contain your repositories. The organization with the same name as your Git provider username contains your personal repositories. The selected organizations will then be synced with Codacy so that managing your team permissions is easy. Read more about what synced organizations do.


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

Choosing an organization

To start adding your repositories, select one of the organizations and click Go to add repositories.

4. Add repositories

Adding repositories

And as a final step, add the repositories that you wish to analyze. Codacy will start the first analysis and set up everything required to ensure your next commits on those repositories are analyzed.

You're all set! 🎉

Read our guide on what to do with a newly added repository to explore static analysis issues and continue configuring your repository.

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 October 1, 2020