Skip to content
WorktreeOS

WSL access

The daemon web UI listens on 127.0.0.1:4949 inside WSL by default. To reach it from outside the Windows host, run the Windows networking setup from an elevated Windows Command Prompt or PowerShell.

1. Allow the port through the firewall

Section titled “1. Allow the port through the firewall”

Either disable the Windows firewall:

Terminal window
netsh advfirewall set allprofiles state off

or keep the firewall enabled and allow inbound TCP on the WorktreeOS web port:

Terminal window
netsh advfirewall firewall add rule ^
  name="WSL 4949" ^
  dir=in ^
  action=allow ^
  protocol=TCP ^
  localport=4949

2. Forward the host port to the WSL instance

Section titled “2. Forward the host port to the WSL instance”
Terminal window
netsh interface portproxy add v4tov4 ^
  listenaddress=0.0.0.0 ^
  listenport=4949 ^
  connectaddress=<IP_WSL> ^
  connectport=4949

Replace <IP_WSL> with the current WSL IP address.

Keep the rule current

Section titled “Keep the rule current”

WSL can assign a new IP after a restart, so update the portproxy rule if external access stops working.