INSTALL

Install the CLI 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 @decentnetwork/beagle
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

Enough for a messenger — peer-to-peer messages and files, no router needed. Open http://localhost:8766 and add a friend's address.

pm2 start "beagle --host 127.0.0.1 --port 8766" --name beagle-ui
pm2 save
pm2 startup

To try it immediately, add Beagle Help (accepts automatically), or join the public groups:

by7wXqRijyBjz79tQtfmBx6CiQ1Y2rhdDUojYugE4LXk2XaNX1WJ

aHzsSgcuKuWrLM2QLehrCrJCH5idWWhkvqKudVUzgpf4EHta6377

↑ beagles — general community. Below: BTCD — BTC and markets.

CotCjqmBrQ3rVwMMgXvm2naRuH2HzqeDPwdqTN7CCdzzagkB8QmM

Optional: start the smart proxy router — Only for routing browser traffic through the network. Skip it if Beagle is just your messenger.

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

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: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?

Next guideIdentity, friends, messages, and files →