Unable to start IU 2025.2 via WSL Gateway: Toolkit configuration issue

October 27, 2026 05:43 Updated

Problem

IntelliJ IDEA (IU) versions 2025.2 and newer fail to start when accessed via the WSL Gateway, while version 2025.1.3 runs correctly.

Cause

The root cause was identified to be an improper toolkit configuration in the idea64.vmoptions file. Alterations in the Java AWT Toolkit settings between different versions led to this inconsistency.

Resolution

Compare the idea64.vmoptions file for the affected version (~/.config/JetBrains/IntelliJIdea2025.2/idea64.vmoptions) with that of a working version (~/.config/JetBrains/IntelliJIdea2025.1/idea64.vmoptions).
Modify the affected vmoptions file to ensure consistency. Specifically:
- Comment out or adjust parameters that might cause the toolkit issue.
- For example, modify toolkit-specific entries:
```
#-Dawt.toolkit.name=WLToolkit
-Dawt.toolkit.name=XToolkit
```
Save the file and restart IntelliJ IDEA via the WSL Gateway. The newer version should now start successfully.

If the issue persists or for further assistance, please collect logs via JetBrains Gateway and provide them to JetBrains support for more detailed analysis.