kubeflow / kubeflow/docs-agent

docs: Document WSL port-forwarding TCP drop fix for Next.js UI

Open
#90 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
42
Forks
111
Avg merge
6d 23m
Merged PRs (30d)
2

Description

Problem

On WSL2, the kubectl port-forward command in kagent-feast-mcp/README.md Step 7 (line 170):

kubectl -n <YOUR_NAMESPACE> port-forward service/kagent-ui 8080:8080

randomly drops TCP connections when accessed from the Windows host browser, resulting in 504 Gateway Time-out errors and React chunk loading failures. This is because WSL2's default NAT bridging does not reliably forward traffic bound to 127.0.0.1 across the VM boundary.

Fix

The command needs --address=0.0.0.0 to bind to all interfaces:

# Before (README Step 7, line 170)
kubectl -n <YOUR_NAMESPACE> port-forward service/kagent-ui 8080:8080

# After
kubectl -n <YOUR_NAMESPACE> port-forward --address=0.0.0.0 service/kagent-ui 8080:8080

Additionally, add a note in the Prerequisites or Troubleshooting section:

### WSL2 users: port-forward drops connections

If the Kagent UI loads but becomes unresponsive or shows 504 errors,
add `--address=0.0.0.0` to the port-forward command. This is a known
WSL2 NAT bridging limitation.

File

  • kagent-feast-mcp/README.md:170 (Step 7) and Troubleshooting section

Context

Discovered during local Kagent PoC validation — #59 (comment)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open kagent-feast-mcp/README.md and inspect Step 7 around line 170, along with the Troubleshooting section. Update the documented port-forward command and add the WSL2 note described in the issue. Done means the README explains the 504 and TCP-drop symptom and shows the all-interfaces command.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes, next.js
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.