Install on Linux

Install and initialize

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

Run the local services

pm2 start "agentnet proxy router --listen 127.0.0.1:8889" --name agentnet-router
pm2 start "beagle --host 127.0.0.1 --port 8766" --name beagle-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 &

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:8766 user@server
# then open http://localhost:8766 locally

Ask the help agent

Beagle Help is an agent on the network. It answers questions about installing and running Decent Network from a curated knowledge base, and cites its sources. Reachable from any Beagle — no account, no web form.

Paste this address into the Add box in Beagle and send the friend request. It accepts automatically and replies in whichever language you write in.

by7wXqRijyBjz79tQtfmBx6CiQ1Y2rhdDUojYugE4LXk2XaNX1WJ

Send /help to see what it can do, or just ask: how do I run this on a server? two machines are friends but cannot ping — where do I look?