You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/guides/troubleshooting.mdx
+3-22Lines changed: 3 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,11 +14,11 @@ Sometimes things go wrong. Below is a list of known issues you might encounter w
14
14
15
15
There's a few known possible causes of this:
16
16
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.
19
19
* Your local install has become corrupted somehow. Reinstalling the latest version of the app should generally resolve this.
20
20
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.
22
22
23
23
### HTTP Toolkit starts, but blank
24
24
@@ -34,25 +34,6 @@ Any time the server crashes, a notification is shown with the error details and
34
34
35
35
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.
36
36
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
-
56
37
### I can't use/don't like Electron
57
38
58
39
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