REST & access

PearData agents expose optional HTTP on loopback for scripts and scrapers. Remote access to the control plane is HyperDHT — not a public REST port.

Local REST

Default: http://127.0.0.1:18888. Disable with PEARDATA_REST=0.

curl -s http://127.0.0.1:18888/api/v3/info
curl -s http://127.0.0.1:18888/api/v3/health
curl -s 'http://127.0.0.1:18888/api/v3/data?chart=system.cpu&after=-60&points=60'
curl -s http://127.0.0.1:18888/api/v3/ai/snapshot

P2P control plane

Desktops dial the agent public key over HyperDHT + protomux-rpc. Roles and invites apply here. Do not expose the REST port to the internet.

Optional tunnels

If you use Holepunch-ecosystem tunnels for other services on the host, treat them as a separate data plane. PearData itself does not require them for metrics or QVAC.