INSTALL

Install on Linux

Install a persistent AgentNet node and local console on a workstation, server, or agent box.

July 2026

Install and initialize

sudo npm install -g pm2 @decentnetwork/lan
agentnet init
sudo agentnet service install

Identity ownership

Run initialization as the account that will use AgentNet. Use sudo only for package and service installation.

Run the local services

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

Follow the command printed by `pm2 startup` to enable boot persistence. Keep the console on loopback unless you have a deliberate authenticated reverse-proxy setup.

Point your browser at the proxy

The router listens at 127.0.0.1:8889. Open a separate Chrome/Chromium window that uses Beagle; your normal browser stays untouched. The binary may be google-chrome-stable or chromium-browser.

google-chrome --proxy-server="127.0.0.1:8889" \
  --user-data-dir="/tmp/chrome-beagle" \
  --proxy-bypass-list="<-loopback>" >/dev/null 2>&1 &

Other options

Or install the ZeroOmega or FoxyProxy extension (HTTP proxy 127.0.0.1 port 8889), or set a GNOME system proxy under Settings → Network. For a full tunnel, start the router with agentnet proxy router --all.

Headless and remote servers

For a remote machine, use the CLI directly or forward the console through SSH instead of binding it publicly.

ssh -L 8765:127.0.0.1:8765 user@server
# then open http://localhost:8765 locally

Next guideIdentity, friends, messages, and files →