How to correctly set up IntelliJ with WSL2

Tags:

Video Answer

1 Answers

Official instructions: wrong or out of date?

The official instructions from JetBrains at https://www.jetbrains.com/help/idea/how-to-use-wsl-development-environment-in-product.html#debugging_system_settings for configuring the Windows Firewall has two parts

(Official) Step 1: allow traffic from WSL (this is right)

The first step in the above link is to add a new inbound rule to allow all traffic from WSL (via PowerShell as Administrator):

New-NetFirewallRule -DisplayName "WSL" -Direction Inbound  -InterfaceAlias "vEthernet (WSL)"  -Action Allow

This command works and adds the new rule.

(Official) Step 2: Remove blocking inbound traffic to IDEA (this is wrong)

The next step in the instructions is to remove the existing rule(s) that block traffic to IntelliJ IDEA:

Get-NetFirewallRule | where DisplayName -ILike "idea*.exe" | Remove-NetFirewallRule

This command doesn't do anything because the filter part where DisplayName -ILike "idea*.exe" does not match anything.

The DisplayName property presumably corresponds to the Name column in the Firewall control panel:

IntelliJ IDEA rules already in Windows Firewall

So you can see that "idea*.exe" won't match there.

If I change the search to:

Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*"

Then I do get all four rules returned in the shell output:

PS C:\Windows\system32> Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*"


Name                  : TCP Query User{6288ADD6-1B2E-4BFF-9317-AEEA34194E04}C:\program files\jetbrains\intellij idea
                        community edition 2021.2\bin\idea64.exe
DisplayName           : IntelliJ IDEA Community Edition 2021.2
Description           : IntelliJ IDEA Community Edition 2021.2
DisplayGroup          :
Group                 :
Enabled               : True
Profile               : Private
Platform              : {}
Direction             : Inbound
Action                : Allow
EdgeTraversalPolicy   : DeferToUser
LooseSourceMapping    : False
LocalOnlyMapping      : False
Owner                 :
PrimaryStatus         : OK
Status                : The rule was parsed successfully from the store. (65536)
EnforcementStatus     : NotApplicable
PolicyStoreSource     : PersistentStore
PolicyStoreSourceType : Local

Name                  : UDP Query User{1AE9E9C6-02EF-4C65-8781-B1050740E936}C:\program files\jetbrains\intellij idea
                        community edition 2021.2\bin\idea64.exe
DisplayName           : IntelliJ IDEA Community Edition 2021.2
Description           : IntelliJ IDEA Community Edition 2021.2
DisplayGroup          :
Group                 :
Enabled               : True
Profile               : Private
Platform              : {}
Direction             : Inbound
Action                : Allow
EdgeTraversalPolicy   : DeferToUser
LooseSourceMapping    : False
LocalOnlyMapping      : False
Owner                 :
PrimaryStatus         : OK
Status                : The rule was parsed successfully from the store. (65536)
EnforcementStatus     : NotApplicable
PolicyStoreSource     : PersistentStore
PolicyStoreSourceType : Local

Name                  : {386E3B53-5E4D-4939-8114-74499BDA8515}
DisplayName           : IntelliJ IDEA Community Edition 2021.2
Description           : IntelliJ IDEA Community Edition 2021.2
DisplayGroup          :
Group                 :
Enabled               : True
Profile               : Public
Platform              : {}
Direction             : Inbound
Action                : Block
EdgeTraversalPolicy   : Block
LooseSourceMapping    : False
LocalOnlyMapping      : False
Owner                 :
PrimaryStatus         : OK
Status                : The rule was parsed successfully from the store. (65536)
EnforcementStatus     : NotApplicable
PolicyStoreSource     : PersistentStore
PolicyStoreSourceType : Local

Name                  : {63ED0AB1-12B9-47F2-9810-D1D446EBF9D8}
DisplayName           : IntelliJ IDEA Community Edition 2021.2
Description           : IntelliJ IDEA Community Edition 2021.2
DisplayGroup          :
Group                 :
Enabled               : True
Profile               : Public
Platform              : {}
Direction             : Inbound
Action                : Block
EdgeTraversalPolicy   : Block
LooseSourceMapping    : False
LocalOnlyMapping      : False
Owner                 :
PrimaryStatus         : OK
Status                : The rule was parsed successfully from the store. (65536)
EnforcementStatus     : NotApplicable
PolicyStoreSource     : PersistentStore
PolicyStoreSourceType : Local

Step 2: Remove blocking inbound traffic to IDEA (right)

When I disable those two Public inbound rules, and have the new added WSL inbound rule in place, then IDEA can run Java correctly where it was failing with the connection error before.

You can achieve the same disabling/removal of these two inbound Public rules for IDEA by one of the following methods:

Option 1: Windows Defender Firewall with Advanced Security > Inbound Rules

In the view as shown in the image above, right click the rules and select "Disable Rule" for each inbound rule on the Public profile.

Option 2: Disable via PowerShell

You can disable the same two rules via PowerShell (as Administrator) with the following command:

Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*" | Disable-NetFirewallRule

Option 3: Remove via PowerShell

You can remove the same two rules via PowerShell (as Administrator) with the following command:

Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*" | Remove-NetFirewallRule

All three of these methods worked for me and allow me to have all Windows Firewall profiles (Domain, Private, Public) enabled, and Java now runs correctly in IDEA on WSL2 projects located in the WSL2 filesystem.

Update: I had to roll back from the latest 2021.2 version to 2021.1.3, because the latest version will "lose" it's ability to connect to the WSL2 filesystem until WSL is restarted.

I have both versions installed, but I had to edit the firewall rules to allow traffic to the 2021.1.3 program (curiously also named 2021.2 in the firewall!) and add the Public profile (was just Private) to the Allow rule.

159

answered Sep 22 '22 03:09

Steve Goossens

Donate For Us

If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!

Donate Us With

How to correctly set up IntelliJ with WSL2

Tags:

intellij-idea

windows-subsystem-for-linux

Jakub Znamenáček

People also ask

Video Answer

1 Answers

Official instructions: wrong or out of date?

(Official) Step 1: allow traffic from WSL (this is right)

(Official) Step 2: Remove blocking inbound traffic to IDEA (this is wrong)

Step 2: Remove blocking inbound traffic to IDEA (right)

Option 1: Windows Defender Firewall with Advanced Security > Inbound Rules

Option 2: Disable via PowerShell

Option 3: Remove via PowerShell

Steve Goossens

Recent Activity

Donate For Us

How to correctly set up IntelliJ with WSL2

Tags:

intellij-idea

windows-subsystem-for-linux

Jakub Znamenáček

People also ask

Video Answer

1 Answers

Official instructions: wrong or out of date?

(Official) Step 1: allow traffic from WSL (this is right)

(Official) Step 2: Remove blocking inbound traffic to IDEA (this is wrong)

Step 2: Remove blocking inbound traffic to IDEA (right)

Option 1: Windows Defender Firewall with Advanced Security > Inbound Rules

Option 2: Disable via PowerShell

Option 3: Remove via PowerShell

Steve Goossens

Related questions

Recent Activity

Donate For Us