Troubleshooting

This section contains information that can help you troubleshoot common problems.

List of Docker image paths

Path	Description
`/data/project`	Root directory of the project to be analyzed
`/data/results`	Directory to store the analysis results
`/opt/idea`	Directory containing the IDE distribution
`/root/.config/idea`	Directory where the IDE contains configuration
`/data/profile.xml`	Used if a profile was not previously configured either via the CLI or the `qodana.yaml` file.

For Maven and Gradle projects, Qodana uses the following directories to access third-party libraries:

Path	Description
`/root/.m2/repository`	Maven project dependencies
`/root/.gradle`	Gradle project dependencies

Mounting these directories saves Qodana from downloading all dependencies again while using these linters:

There are several options for examining Qodana behavior using the /data/results directory:

The /data/results/projectStructure/Modules.json file lists all modules detected by Qodana. It should be identical to the list that you expect to see while opening the project in IDEA. If it is not the case, check pom.xml for Maven or the build.gradle file for Gradle configurations.
In the /data/results/ directory, each inspection that detected a possible problem creates its own file named ID.json, where ID is the inspection name that can be used in qodana.yaml for including or excluding inspections. You can find the complete list of inspection IDs in the /data/results/.descriptions.json file using the /groups/*/inspections/*/shortName pattern.
In /data/results/log/idea.log, you can investigate suspicious warnings.

Last modified: 02 June 2022