Documentation

Everything you need to run, harden, and extend PearData — from first public key to multi-agent fleets and on-device QVAC. Peer-to-peer by design: dial by identity, not by public ports.

Concepts

How PearData works

Deep explainer: P2P identity, metrics push, anomalies, security, and fleet model.

Start here

Quick start

One-line install.sh, systemd agent, desktop client, and first connection.

Design

Architecture

Agent pipeline, HyperDHT RPC, REST plane, HyperDB warm store, QVAC on desktop.

Production

Operator guide

systemd, roles, retention / Data Manager, optional Docker metrics, backups.

Access

REST & tunnels

Local REST (:18888) and optional tunnel patterns for agent APIs.

Hardening

Security model

Admin seed proof, pd1 invites, roles, revoke, threat model, checklist.

Reference

RPC & REST

Method groups, metric pushes, AI composites, roles, protocol versioning.

Releases

Host matrix, Bare agent, Electron clients, QVAC packaging, rolling tag.

Help

FAQ

Keys, invites, peers, charts, QVAC, Pear, AGPL.

Install in one command

curl -fsSL https://install.peardata.rest | bash

Interactive installer: agent (Linux + systemd; Docker metrics optional) or desktop client. After the server starts, check /opt/peardata/.env for SERVER_PUBLIC_KEY and SERVER_SEED, then connect from the desktop client (public key = viewer, key + seed = admin, or a full pd1. invite for operators). See Quick start and Download.

What is PearData?

PearData is decentralized P2P real-time host monitoring on the Holepunch stack. There is no central control plane. Each machine runs a lightweight agent that collects metrics and answers RPC. Desktops dial by Ed25519 public key over Noise-encrypted HyperDHT. Optional agent-style REST on localhost supports scripts and Grafana. The desktop UI includes Overview, Charts, custom Dashboards, Alerts, Logs, Processes, Fleet, Data Manager, and on-device QVAC AI. Owned by HoneyPeer, LLC. License: AGPL-3.0-only.

Layer	Technology
Transport	HyperDHT (Noise-encrypted P2P)
RPC	protomux-rpc + compact-encoding JSON
Client	Pear desktop / Electron shell
Warm store	HyperDB + Corestore
Local AI	QVAC (on-device, optional)
HTTP	Agent REST `/api/v1\|v2\|v3` (localhost default)
License	AGPL-3.0-only