Installation Guide for Jetbrains Qodana Ultimate

1) Create Qodana Cloud Project

1. Go to Qodana Cloud (JetBrains platform).
2. Create:
   • Organization
   • Team
   • Project
3. Copy the Project Token (QODANA_TOKEN) → required for authentication & licensing.

2) Choose Installation Method

Option A: Install via CLI (Recommended)

1. Install Docker or Podman (required).
2. Install Qodana CLI:

   brew install jetbrains/utils/qodana   # macOS
   

   OR download CLI from JetBrains GitHub.

3. Run analysis:

   qodana scan \
     -e QODANA_TOKEN="<your-token>" \
     --linter qodana-<language>
   

Option B: Run via Docker (Direct)

docker run \
  -v <project-path>/:/data/project/ \
  -e QODANA_TOKEN="<your-token>" \
  jetbrains/qodana-<linter>:2025.3

Option C: Use in JetBrains IDE (Easiest)

Supported IDEs include:

• IntelliJ IDEA
• PyCharm
• PhpStorm
• WebStorm
• GoLand
• Rider

Steps:

1. Open your project in IDE
2. Go to Problems → Qodana tab
3. Click “Try locally”
4. View results inside IDE or browser

Option D: CI/CD Integration (GitHub, GitLab, Jenkins)

• Add QODANA_TOKEN as secret/variable
• Use official Qodana GitHub Action or pipeline config

3) Activation Process (Qodana Ultimate License)

1. Purchase or activate Qodana Ultimate license (linked to JetBrains account)
2. Complete Qodana Cloud project setup
3. Generate QODANA_TOKEN from Qodana Cloud
4. Use QODANA_TOKEN in CLI, Docker, or CI/CD
5. Qodana automatically verifies the license via Qodana Cloud during execution
6. (Optional)
   • Open IDE
   • Go to Help → Register → Activate New License
   • Choose JetBrains Account
   • Login and activate