Qodana IntelliJ Docker Image
We provide a Docker image for the Qodana IntelliJ linter to support different usage scenarios:
Running the analysis on a regular basis as part of your continuous integration (CI-based execution)
Single-shot analysis (for example, performed locally ).
If you are familiar with JetBrains IDEs code inspections and know what to expect from the static analysis outside the editor, you can skip the following section and continue from Using an existing profile.
If you are just starting in the field, we recommend proceeding with the default setup we provide. You will see the results of the most common checks performed on your code base. Later, you can adjust them to suit your needs better.
Quick start with the recommended profile
Run analysis locally
Pull the image from Docker Hub (only necessary to update the
latestversion):docker pull jetbrains/qodana
Run the following command:docker run --rm -it -p 8080:8080 \ -v <source-directory>/:/data/project/ \ -v <output-directory>/:/data/results/ \ jetbrains/qodana --show-report
output-directoryare full local paths to, respectively, the project source code directory and the analysis results directory.
This command will run the analysis on your source code and start the web server to provide a convenient view of the results. Open
http://localhost:8080in your browser to examine the found problems and performed checks. Here, you can also reconfigure the analysis. See the UI section of this guide for details. When done, you can stop the web server by pressing
Ctrl-Cin the Docker console.
In case you don't need the user interface and prefer to study raw data, use the following command:docker run --rm -it \ -v <source-directory>/:/data/project/ \ -v <output-directory>/:/data/results/ \ jetbrains/qodana
If you run the analysis several times in a row, make sure you've cleaned the results' directory before using it in
Run analysis in CI
Use the following command as the task in generic Shell executor:docker run --rm \ -v <source-directory>/:/data/project/ \ -v <output-directory>/:/data/results/ \ jetbrains/qodana
output-directoryare full paths to, respectively, the project source code directory and the analysis results directory.
Example for GitHub Workflow (
Example for GitLab CI (
Using an existing profile
This section is intended for users familiar with configuring code analysis via IntelliJ inspection profiles.
You can pass the reference to the existing profile in multiple ways. Here are some examples:
Mapping the profile to
/data/profile.xmlinside the container:docker run --rm -it -p 8080:8080 \ -v <source-directory>/:/data/project/ \ -v <output-directory>/:/data/results/ \ -v <inspection-profile.xml>:/data/profile.xml jetbrains/qodana --show-report
Using the name of the profile in your project
.idea/inspectionProfiles/folder:docker run --rm -it -p 8080:8080 \ -v <source-directory>/:/data/project/ \ -v <output-directory>/:/data/results/ \ jetbrains/qodana --show-report -profileName php.extended
Configure via qodana.yaml
qodana.yaml file will be automatically recognised and used for the analysis configuration, so that you don't need to pass any additional parameters.
The references to the inspection profiles will be resolved in a particular order. To learn about the format, refer to the
Paid plugins are not yet supported. Each vendor must clarify licensing terms for CI usage and collaborate with us to make it work.
Any free IntelliJ platform plugins or your custom plugin can be added by mounting it to the container plugins' directory using the following command:
Refer to the technical guide for more details.
According to the JetBrains EAP user agreement, we can use third-party services to analyze the usage of our features to further improve the user experience. All data will be collected anonymously. You can disable the reporting of usage statistics by adjusting the options of the Docker command you use. Refer to the technical guide for details.
The Docker image includes the evaluation license, which will expire in 30 days. Make sure to pull a new image on time.