IntelliJ IDEA Fix, Crash & Optimization Guide

IntelliJ IDEA is JetBrains' Java/Kotlin IDE (Community and Ultimate editions). It runs on Windows, macOS, and Linux on the JetBrains Runtime (a customized JDK). This guide covers real, common startup and performance problems.

Install / First Setup

The easiest path is the JetBrains Toolbox, which manages installs and updates. The IDE launches with the idea binary.

Windows

winget install -e --id JetBrains.IntelliJIDEA.Community
# or download the installer from jetbrains.com/idea

macOS

brew install --cask intellij-idea

Linux

sudo snap install intellij-idea-community --classic
# or extract the official .tar.gz and run bin/idea.sh

Your config and caches live under ~/.config/JetBrains/IntelliJIdea* (Linux), ~/Library/Application Support/JetBrains/IntelliJIdea* (macOS), and %APPDATA%\JetBrains\IntelliJIdea* (Windows).

Common Issues & Fixes

"Cannot find a valid JVM installation" / "No JVM installation found"

Cause: The bundled JetBrains Runtime (JBR) is missing, or JAVA_HOME/IDEA_JDK points at an incompatible or absent JDK. Fix: Reinstall the IDE so the bundled JBR is restored, or set IDEA_JDK (or JAVA_HOME) to a compatible JDK 17/21. On most setups the bundled JBR is all you need — don't override it unless you have a reason.

Indexing slow / "Updating indices" runs forever

Cause: A huge project, folders that should be excluded (e.g. node_modules, build, generated sources), or too little heap. Fix: Mark heavy directories as Excluded in Project Structure, then File > Invalidate Caches / Restart. Raise the heap in Help > Change Memory Settings (edits idea64.vmoptions, the -Xmx value).

Plugin incompatible with the current IDE build

Cause: A plugin hasn't been updated for the newly installed IDE version. Fix: Update the plugin from Settings > Plugins. If no update exists, either roll back the IDE or disable the plugin temporarily. The IDE warns "Plugin 'X' is incompatible with the current build" on startup — disable it there.

Out of memory / "GC overhead limit exceeded"

Cause: The default heap is too small for the project. Fix: Help > Change Memory Settings and increase -Xmx (e.g. 2048m–4096m depending on RAM). For a manual edit, change -Xmx in idea64.vmoptions and restart.

"Error: Could not create the Java Virtual Machine" on launch

Cause: A corrupt or over-sized vmoptions file (e.g. an -Xmx larger than available RAM). Fix: Reset via Help > Edit Custom VM Options with valid values, or delete the custom idea64.vmoptions so the IDE falls back to defaults.

UI lag or input issues on Linux (especially Wayland)

Cause: Java's windowing integration with non-reparenting/ Wayland compositors. Fix: On X11 sessions it generally works out of the box. On Wayland you can try setting export _JAVA_AWT_WM_NONREPARENTING=1 before launch, or run on an X11 session. For rendering glitches, Help > Edit Custom VM Options and add -Dsun.java2d.opengl=true only if your driver supports it.

Performance & Optimization

• Exclude generated/build directories from indexing so the project re-indexes cheaply.
• Keep the heap sized to your RAM (via Help > Change Memory Settings) rather than the conservative default.
• Disable plugins you don't use — each adds startup and indexing cost.
• Use File > Invalidate Caches / Restart after large dependency or branch changes.

Version & Compatibility Notes

IntelliJ IDEA uses a yearly version scheme (e.g. 2023.x, 2024.x) with periodic minor updates, and ships on the JetBrains Runtime. Plugin compatibility is tied to the exact IDE build. For supported JDK versions and current releases, consult the official JetBrains documentation.

FAQ

Q: How do I increase IntelliJ IDEA's memory? A: Open Help > Change Memory Settings and raise the Maximum Heap (-Xmx), then restart. This edits the idea64.vmoptions file for you.

Q: Why is indexing taking so long? A: Usually large or un-excluded directories (build output, dependencies). Exclude them in Project Structure and Invalidate Caches / Restart.

Q: What JDK does IntelliJ IDEA use? A: It ships with a bundled JetBrains Runtime (JBR). You normally don't need a separate JDK unless you explicitly set IDEA_JDK or JAVA_HOME.

Q: A plugin says it's incompatible — what do I do? A: Update it from Settings > Plugins. If no update is available, disable it or roll back the IDE version until the plugin supports it.

Q: How do I reset all settings? A: Close the IDE and remove/rename its config directory under ~/.config/JetBrains/IntelliJIdea* (Linux), ~/Library/Application Support/JetBrains/IntelliJIdea* (macOS), or %APPDATA%\JetBrains\IntelliJIdea* (Windows).

Related Guides

• PyCharm Fix & Optimization Guide
• WebStorm Fix & Optimization Guide

Accuracy Note

Commands and paths reflect common, real-world setups as of 2026-08. Always verify against your installed version and OS. When in doubt, consult the official JetBrains documentation.