Skip to content

Commit 399bda7

Browse files
committed
Add WSL2/Docker issue to troubleshooting docs
1 parent f30c029 commit 399bda7

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

src/content/docs/guides/troubleshooting.mdx

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,25 @@ Any time the server crashes, a notification is shown with the error details and
3434

3535
If you're seeing this, you've found something that completely crashes the running server. It might be some very unusual HTTP traffic, a specific use of an interceptor, or something else, but regardless [please get in touch](/contact/) with any details you have, as this is definitely a bug that needs fixing.
3636

37+
### HTTP Toolkit conflicts with Hyper-V
38+
39+
HTTP Toolkit uses ports 45456 and 45457. On Windows, Hyper-V (used by WSL2 and Docker) randomly reserves ports for its own use, and may select ranges that include these, which prevents HTTP Toolkit from starting.
40+
41+
To fix this, you need to ensure HTTP Toolkit is running _before_ Hyper-V seizes these ports, in which case it will automatically use a different range. You can also set `excludedportrange` to disable automatic reservations of these ports entirely, to avoid issues in future.
42+
43+
To do so:
44+
45+
* Open an Administrator command prompt
46+
* Run `net stop winnat`
47+
* Restart HTTP Toolkit
48+
* Run the below to stop these ports from being reserved by Hyper-V in future:
49+
```
50+
netsh int ipv4 add excludedportrange protocol=tcp startport=45456 numberofports=2
51+
```
52+
* Run `net start winnat`
53+
54+
If this doesn't work, please share more information in [the GitHub issue](https://github.com/httptoolkit/httptoolkit/issues/611) discussing this problem.
55+
3756
### I can't use/don't like Electron
3857

3958
In some environments the Electron wrapper can cause problems, and some people prefer to avoid Electron apps entirely to manage their memory usage. The tradeoffs of Electron are a whole debate that we can get into elsewhere, but if you want to, it is entirely possible to use HTTP Toolkit without it. To do so:

0 commit comments

Comments
 (0)