Skip to content

Commit 0ae4218

Browse files
Update netsh http iplisten command
1 parent 7a800f1 commit 0ae4218

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

docs/backgroundservice.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,14 @@ To operate properly the background service needs to be able to register an http
6262

6363
#### Enable http listener IP address
6464

65-
**You do not normally have to configure any netsh iplisten rules, unless your system already has retrictions in place.**
65+
**You do not normally have to configure any netsh iplisten rules, unless your system already has restrictions in place.**
66+
67+
First check if you have any existing iplisten rules are defined:
68+
```bat
69+
netsh http show iplisten
70+
```
71+
72+
If any are listed (other than `0.0.0.0`) then further IP listeners on different IPs need to be added.
6673

6774
If your system is restricting which IP addresses can listen for HTTP traffic you may find you need to enable iplisten for the service IP.
6875

@@ -85,7 +92,7 @@ netsh http add iplisten ipaddress=127.0.0.2
8592
You should monitor other effects on other services when changing the IP listen configuration. We have seen one report of Exchange/Outlook slowing down when the 0.0.0.0 address iplisten is enabled.
8693

8794
:::info
88-
Check your current system IP listener rules using `netsh show iplisten`. If you have any IP listen rules *already configured* not using the catch-all `0.0.0.0` IP then your system will not listen on the default 127.0.0.2 IP and you will need to run `netsh http add iplisten ipaddress=127.0.0.2` to allow the service listener to work.
95+
Check your current system IP listener rules using `netsh http show iplisten`. If you have any IP listen rules *already configured* not using the catch-all `0.0.0.0` IP then your system will not listen on the default 127.0.0.2 IP and you will need to run `netsh http add iplisten ipaddress=127.0.0.2` to allow the service listener to work.
8996
:::
9097

9198
#### Allow Local System account to bind an http listener to the service port

0 commit comments

Comments
 (0)