All docs/Install on Windows (WSL2)
INSTALL

Install on Windows (WSL2)

Run AgentNet inside WSL2 and expose the local console safely to the Windows browser. Prefer the native guide unless policy blocks it.

July 2026

Prepare WSL2

01
Install WSL2

Run PowerShell as Administrator, then restart if requested.

wsl --install
02
Open Ubuntu

Complete the Linux username and password setup, then install Node.js 20+ inside WSL.

03
Install packages

Run these commands in the Ubuntu terminal.

sudo npm install -g pm2 @decentnetwork/lan
04
Create identity and service

Initialize as the WSL user, then install the network helper.

agentnet init
sudo agentnet service install

Start services for the Windows browser

pm2 start "agentnet proxy router --listen 0.0.0.0:8889" --name agentnet-router
pm2 start "agentnet ui --listen 0.0.0.0:8765" --name agentnet-ui
pm2 save

Open http://localhost:8765 in Windows. WSL2 forwards localhost traffic to the Linux environment on current Windows versions.

Windows firewall

If localhost forwarding is disabled or a firewall blocks it, allow the WSL process only on trusted/private networks. Do not expose the console to an untrusted LAN.

Point Windows Chrome at the proxy

You browse from Windows, and Windows forwards localhost to WSL, so point Windows Chrome at 127.0.0.1:8889. Run this in Windows PowerShell (not inside WSL); your normal Chrome stays untouched.

& "$env:ProgramFiles\Google\Chrome\Application\chrome.exe" `
  --proxy-server="127.0.0.1:8889" `
  --user-data-dir="$env:TEMP\chrome-beagle" `
  --proxy-bypass-list="<-loopback>"
Other options

Or install the ZeroOmega or FoxyProxy extension and add an HTTP proxy at 127.0.0.1 port 8889. Want every site through the exits? Start the router with agentnet proxy router --all.

Verify

agentnet identity show
agentnet doctor
pm2 status
Next guideInstall on Windows (Native, no WSL)