FoldOps

Fleet monitoring

FoldOps is a distributed Folding@home farm monitoring and management platform. Agents on each node report metrics every 60 seconds to a central supervisor, which stores snapshots in SQLite and serves a React dashboard.

Agent

Runs on every Folding@home node. Collects system metrics — CPU, memory, disk, temperatures — plus FAH status, PPD, work units, and pending apt updates. Posts snapshots to the supervisor every 60 seconds.

foldops-agent

Supervisor

Runs on one node in your fleet (for example, fah-01). Receives agent reports, stores history in SQLite, and exposes a REST API for the dashboard and automation.

foldops-supervisor

Web

React dashboard for your entire farm. View node health, Folding@home progress, temperatures, update status, and alerts from a single pane of glass.

foldops-web

Install via apt

Prebuilt packages are published to deb.folding-os.com. Add the repository, then install the agent on every FAH node and the supervisor on your central host.

Terminal

curl -fsSL https://deb.folding-os.com/foldops-archive-keyring.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/foldops.gpg

echo 'deb [signed-by=/usr/share/keyrings/foldops.gpg] https://deb.folding-os.com stable main' \
  | sudo tee /etc/apt/sources.list.d/foldops.list

sudo apt update
sudo apt install foldops-agent              # every FAH node
sudo apt install foldops-supervisor         # supervisor node (fah-01)

Configure /etc/foldops/agent.env and /etc/foldops/supervisor.env, then enable the systemd units. Upgrade with sudo apt install --only-upgrade foldops-agent foldops-supervisor foldops-web.

Documentation & source

Full guides for architecture, configuration, API reference, and deployment live in the FoldOps repository.

Screenshots Farm dashboard, node history, agent deployment, and alert monitoring Documentation Installation, architecture, API, agent, and configuration guides Installation guide apt setup, environment files, and systemd configuration Architecture System design, components, and data flow GitHub repository pacificnm/foldops — agent, supervisor, and dashboard source

View on GitHub Back Home