Skip to content

Commit 3a74af0

Browse files
committed
Update docs now that auto-config ports are live
1 parent e103b51 commit 3a74af0

1 file changed

Lines changed: 3 additions & 22 deletions

File tree

src/content/docs/guides/troubleshooting.mdx

Lines changed: 3 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ Sometimes things go wrong. Below is a list of known issues you might encounter w
1414

1515
There's a few known possible causes of this:
1616

17-
* The ports HTTP Toolkit uses are in use. HTTP Toolkit uses ports 45456 and 45457 for internal communication, and then selects a separate port for the proxy automatically. If one of those ports is in use, or there are no free ports available, HTTP Toolkit will fail to start.
18-
* A previous run of HTTP Toolkit has crashed without cleaning up after itself, and is still using these ports. To resolve this, you will need to kill the background `httptoolkit-server` node process.
17+
* No free ports are available. HTTP Toolkit selects ports automatically for its internal communication and for the proxy, but if there are no free ports available at all, it will fail to start.
18+
* A previous run of HTTP Toolkit has crashed without cleaning up after itself, and is still running in the background. To resolve this, you will need to kill the background `httptoolkit-server` node process.
1919
* Your local install has become corrupted somehow. Reinstalling the latest version of the app should generally resolve this.
2020

21-
If you hit this issue, please get in touch. Right now there's no well known applications using these ports, so all these possibilities are very unusual, and it's possible that they'll be solvable with more investigation.
21+
If you hit this issue, please get in touch.
2222

2323
### HTTP Toolkit starts, but blank
2424

@@ -34,25 +34,6 @@ 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-
5637
### I can't use/don't like Electron
5738

5839
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)