Qodana 2023.2 Help

Quick start

The current version of Qodana (2023.2) provides the linters that let you analyze Java, Kotlin, Groovy, PHP, JavaScript, TypeScript, C#, Visual Basic, C, C++, Python, and Golang projects. You can also extend the default linter configuration using various features.

As an example, this section explains how you can quickly start working with Qodana using:


Depending on your Qodana license, you probably need to obtain a trial license and accomplish the onboarding stage at Qodana Cloud.

To run Qodana in the CLI and GitHub, you will be using a project token available after creating a Qodana Cloud project. To learn more about it, see the Project tokens section.

Run Qodana in JetBrains IDEs

Starting from version 2023.2, Qodana is available in IntelliJ IDEA and PyCharm (both the Professional and Community editions), PhpStorm, WebStorm, GoLand, and Rider.

Here is the short video showing how you can run Qodana in your IDE.

Running Qodana in an IDE

Here is the description of all steps shown in this video:

  1. In your IDE, navigate to the Problems tool window.

  2. In the Problems tool window, click the Server-Side Analysis tab.

  3. On the Server-Side Analysis tab, click the Start Qodana button.

  4. In the dialog that opens, click the Try locally button, and then click Run.

  5. On the Server-Side Analysis tab, you can view inspection results. It also contains two links in the upper part of the tab.

    Links on the Server-Side Analysis tab

    Open the inspection report in an intuitive and easy-to-use form.

    Qodana report

    Open the configuration wizard for using Qodana in CI/CD pipelines.

    Qodana report

    To learn more about Qodana and CI/CD pipelines, see the Integration with CI systems section.

Run Qodana using CLI

Qodana provides two options for local analysis of your code. Qodana CLI is the easiest option to start. Alternatively, you can use the Docker command from the Docker image tab.

To run Qodana CLI in the default mode, you must have Docker or Podman installed and running locally. If you are using Linux, you should be able to run Docker under your current non-root user.

  1. Install Qodana CLI on your machine using available options:

    Install with Homebrew (recommended):

    brew install jetbrains/utils/qodana

    Alternatively, you can install Qodana CLI using our installer:

    curl -fsSL https://jb.gg/qodana-cli/install | bash

    Install with Scoop:

    scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils scoop install qodana

    Install with Go:

    go install github.com/JetBrains/qodana-cli@latest
  2. In the project root directory, run this command:

    qodana init

    This will create the qodana.yaml file containing all necessary configuration options.

  3. In the project root directory, run this command to inspect your code:

    qodana scan \ -e QODANA_TOKEN="<cloud-project-token>" \ --show-report

    Here, the QODANA_TOKEN variable contains the project token described in the prerequisites.

This section assumes that you have the Docker application deployed on your machine.

  1. Pull the image from Docker Hub (only necessary to get the latest version):

    docker pull <image>

    Here, image denotes the Docker image name of a Qodana linter from this table:

    Image name



    Java and Kotlin for Server Side projects, based on IntelliJ IDEA Ultimate.


    Java and Kotlin for Server Side projects, based on IntelliJ IDEA Community.


    Java and Kotlin for Server Side projects, based on IntelliJ IDEA with the Android support.


    PHP projects, based on PhpStorm.


    Python projects, based on PyCharm Professional.


    Python projects, based on PyCharm Community.


    JavaScript and TypeScript projects, based on WebStorm.


    Golang projects, based on Goland.


    .NET projects, based on Rider.

  2. Run this command to analyze your codebase:

    docker run \ -p 8080:8080 \ -v <source-directory>/:/data/project/ \ -e QODANA_TOKEN="<cloud-project-token>" \ jetbrains/qodana-<linter> \ --show-report

    Here, <source-directory> points to the root of your project, and the QODANA_TOKEN variable contains the project token described in the prerequisites.

  3. Check inspection results in your browser at http://localhost:8080.

Run Qodana on GitHub

Here is the short video showing how you can configure and run Qodana in GitHub.

Running Qodana in GitHub

Assuming that you already generated a project token as described in the Prerequisites chapter, follow these steps to configure Qodana in GitHub:

  1. On the Settings tab of the GitHub UI, create the QODANA_TOKEN encrypted secret and save the project token as its value.

  2. On the Actions tab of the GitHub UI, set up a new workflow and create the .github/workflows/code_quality.yml file.

  3. To inspect the main branch, release branches, and the pull requests coming to your repository, save this workflow configuration to the .github/workflows/code_quality.yml file:

    name: Qodana on: workflow_dispatch: pull_request: push: branches: - main - 'releases/*' jobs: qodana: runs-on: ubuntu-latest permissions: contents: write pull-requests: write checks: write steps: - uses: actions/checkout@v3 with: ref: ${{ github.event.pull_request.head.sha }} # to check out the actual pull request commit, not the merge commit fetch-depth: 0 # a full history is required for pull request analysis - name: 'Qodana Scan' uses: JetBrains/qodana-action@v2023.2 env: QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}

Next steps

Last modified: 16 November 2023