For the latest updates and improvements, see the latest Cloud documentation instead.
Troubleshooting Codacy¶
This page includes information to help you troubleshoot issues that you may come across while installing, configuring, and operating Codacy.
If the information provided on this page is not enough to solve your issue, contact support@codacy.com providing:
- The description of the issue
- All the information that you were able to obtain while following these troubleshooting instructions
- The collected logs of your Codacy instance
-
The version of your Codacy instance
Tip
To see the version of your Codacy Self-hosted instance click your avatar on the top right-hand corner of any Codacy page:
Git provider integrations¶
The following sections help you troubleshoot the integration of Codacy with your Git provider.
GitHub Cloud and GitHub Enterprise authentication¶
404 error¶
While trying to authenticate on GitHub you get the following error message:
This might mean that there is a mismatch in the Client ID that Codacy is using to authenticate on GitHub.
To solve this issue:
- Make sure that the value of
clientId
in yourvalues-production.yaml
file is the same as the Client ID of the GitHub App that you created - If the values were different, update your configuration and re-execute the
helm upgrade
command as described for GitHub Cloud or GitHub Enterprise
If the error persists:
- Take note of the parameter
client_id
in the URL of the GitHub error page (for example,Iv1.0000000000000000
) - Check if the value of the parameter matches the value of the Client ID of your GitHub App
GitLab Cloud and GitLab Enterprise authentication¶
Invalid redirect URI¶
While trying to authenticate on GitLab you get the following error message:
This might mean that the redirect URIs are not correct in the GitLab application that Codacy is using to authenticate on GitLab.
To solve this issue:
- Open the GitLab application that you created on GitLab Cloud or GitLab Enterprise
- Make sure that all the redirect URIs have the correct protocol for the Codacy instance endpoints, either
http://
orhttps://
- Make sure that all the redirect URIs have the full path with the correct case, since the field is case-sensitive
If the error persists:
- Take note of the parameter
redirect_uri
in the URL of the GitLab error page (for example,https%3A%2F%2Fcodacy.example.com%2Flogin%2FGitLab
orhttps%3A%2F%2Fcodacy.example.com%2Flogin%2FGitLabEnterprise
) - Decode the value of the parameter using a tool such as urldecoder.com (for example,
https://codacy.example.com/login/GitLab
orhttps://codacy.example.com/login/GitLabEnterprise
) - Check if the decoded value matches one of the redirect URIs of your GitLab application
Unknown client¶
While trying to authenticate on GitLab you get the following error message:
This might mean that there is a mismatch in the Application ID that Codacy is using to authenticate on GitLab.
To solve this issue:
- Make sure that the value of
clientId
in yourvalues-production.yaml
file is the same as the Application ID of the GitLab Cloud or GitLab Enterprise application that you created - If the values were different, update your configuration and re-execute the
helm upgrade
command as described for GitLab Cloud or GitLab Enterprise
If the error persists:
- Take note of the parameter
client_id
in the URL of the GitLab error page (for example,cca35a2a1f9b9b516ac927d82947bd5149b0e57e922c9e5564ac092ea16a3ccd
) - Check if the value of the parameter matches the value of the Application ID of your GitLab application
Bitbucket Cloud authentication¶
Invalid client_id¶
While trying to authenticate on Bitbucket Cloud you get the following error message:
This might mean that there is a mismatch in the OAuth consumer Client ID that Codacy is using to authenticate on Bitbucket Cloud.
To solve this issue:
- Make sure that the value of
key
in yourvalues-production.yaml
file is the same as the Key of the Bitbucket OAuth consumer that you created - If the values were different, update your configuration and re-execute the
helm upgrade
command as described for Bitbucket Cloud
If the error persists:
- Take note of the parameter
client_id
in the URL of the Bitbucket Cloud error page (for example,r8QJDkkxj8unYfg4Bd
) - Check if the value of the parameter matches the value of the Client ID of your Bitbucket OAuth consumer
Codacy configuration¶
The following sections help you troubleshoot the Codacy configuration.
Accessing the RabbitMQ dashboard¶
We use RabbitMQ for the internal message queue between our components.
If you need to access the RabbitMQ dashboard:
-
Create a
port-forward
from therabbitmq
pod to your local machine, replacing<namespace>
with the namespace in which Codacy was installed:kubectl port-forward codacy-rabbitmq-ha-0 15672:15672 --namespace=<namespace>
Important
If you are using MicroK8s use
microk8s.kubectl
instead ofkubectl
. -
Access the RabbitMQ dashboard on the address
localhost:15672
, and log in with the configured RabbitMQ credentials.The default RabbitMQ credentials are the following:
- Username:
rabbitmq-codacy
- Password:
rabbitmq-codacy
- Username:
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?
255 characters left
We're sorry to hear that. Please let us know what we can improve:
255 characters left
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 support@codacy.com.