Skip to content

Commit b3faca4

Browse files
niilooykatmayb
andauthored
docs: add Chrome 142+ Private Network Access troubleshooting (#1559)
## Description Adds troubleshooting documentation for Chrome 142+ blocking localhost connections to LangSmith Studio. ## Problem Starting with Chrome version 142, users are experiencing "Failed to initialize Studio" errors when trying to connect LangSmith Studio to their local development server via `langgraph dev`. This is due to Chrome's full enforcement of the Private Network Access (PNA) specification, which blocks HTTPS sites from accessing HTTP localhost servers by default. ## Changes - Added new "Chrome Connection Issues" section to `src/langsmith/troubleshooting-studio.mdx` - Documented symptoms users will encounter - Provided step-by-step solution to allow local network access in Chrome settings - Added additional troubleshooting steps for browser extensions, dependency updates, and cache clearing ## Testing - [x] Verified markdown syntax is correct - [x] Confirmed no linting errors - [x] Tested that links and formatting render correctly ## References - [Support article](https://support.langchain.com/articles/1897181200-private-network-access-blocking-langsmith-studio-connection) --------- Co-authored-by: Kathryn May <[email protected]>
1 parent 920ad28 commit b3faca4

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

src/langsmith/troubleshooting-studio.mdx

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,53 @@ Use this URL in Safari to load Studio. Here, the `baseUrl` parameter specifies y
3636

3737
Chrome and other Chromium browsers allow HTTP on localhost. Use `langgraph dev` without additional configuration.
3838

39+
## Chrome connection issues
40+
41+
Starting with Chrome version 142, you may experience "Failed to initialize Studio" errors with "TypeError: Failed to fetch" when trying to connect [LangSmith Studio](/langsmith/studio) to your local development server via [`langgraph dev`](/langsmith/cli). This occurs even when the API server at `http://127.0.0.1:2024/docs` loads successfully.
42+
43+
**Root Cause:** Chrome 142 fully enforces the Private Network Access (PNA) specification with no fallback, which blocks HTTPS sites (like `https://smith.langchain.com`) from accessing HTTP localhost servers by default.
44+
45+
### Symptoms
46+
47+
- Running `langgraph dev` starts the server successfully.
48+
- Navigating to `http://127.0.0.1:2024/docs` shows the API documentation correctly.
49+
- LangSmith Studio at `https://smith.langchain.com` shows: "Failed to initialize Studio - Please verify if the API server is running or accessible from the browser. TypeError: Failed to fetch".
50+
- Browser console shows errors like: `Permission was denied for this request to access the 'unknown' address space`.
51+
52+
### Solution: Allow local network access in Chrome
53+
54+
1. Open LangSmith Studio at `https://smith.langchain.com` in Chrome.
55+
2. Click the **lock icon** (or site information icon) to the left of the address bar.
56+
3. Look for the **"Local network access"** option in the dropdown.
57+
4. Change the setting from **"Ask (default)"** or **"Block"** to **"Allow"**.
58+
5. Reload the page.
59+
60+
Studio should now connect to your local development server successfully.
61+
62+
### Additional troubleshooting
63+
64+
**Check for browser extension conflicts**
65+
66+
Browser extensions (especially Ollama Chrome extension or AI model extensions) can interfere with localhost connections:
67+
68+
1. Disable all browser extensions temporarily.
69+
2. Restart Chrome.
70+
3. Try connecting to Studio again.
71+
4. If it works, re-enable extensions one by one to identify the culprit.
72+
73+
**Verify dependencies are up to date**
74+
75+
```shell
76+
pip install -U "langgraph-cli[inmem]"
77+
```
78+
79+
**Clear browser cache and site data**
80+
81+
1. In Chrome, go to **Settings** > **Privacy and Security** > **Site Settings**.
82+
2. Find `https://smith.langchain.com` in the list.
83+
3. Click **Clear data**.
84+
4. Restart Chrome and try again.
85+
3986
## Brave Connection Issues
4087

4188
Brave blocks plain-HTTP traffic on localhost when Brave Shields are enabled. When running Studio with `langgraph dev`, you may see "Failed to load assistants" errors.

0 commit comments

Comments
 (0)