FoldingOS logo FoldingOS
Get started

Download

The v0.1.0 runtime is complete and can be built from source using the folding-os repository — bootable x86_64 appliance with verified Folding@home 8.5.6 integration. Public install images are not published yet. You can also install FoldOps on existing Debian nodes today.

v0.1.0 runtime — build from source

Milestones 1 and 2 are complete with QEMU and physical validation. See the README, build system docs, and roadmap.

Public release images — not yet published

Runtime gates are satisfied, but downloadable install images remain blocked until release metadata finalization. Milestone 3 adds network fleet provisioning.

Install FoldOps via apt

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

foldops-agent

Install on every Folding@home node. Reports system metrics, FAH status, temperatures, and pending updates every 60 seconds.

foldops-supervisor

Install on one host in your fleet. Receives agent reports, stores history in SQLite, and serves the REST API.

foldops-web

React dashboard for your farm. Typically installed alongside the supervisor on your central node.

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)

Requires Debian with fah-client and outbound HTTPS to deb.folding-os.com. 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.

Next steps

Everything you need to go from apt install to a monitored farm.

FoldingOS repository Sources, build scripts, and documentation for building from scratch Build system Build goals, framework, outputs, and developer workflow FoldOps installation Full apt setup, environment files, and systemd configuration Configuration Environment variables and secrets for agent and supervisor FoldOps overview How agent, supervisor, and web fit together Screenshots See the dashboard, alerts, and deployment UI in action
Read install docs All documentation