PiHerder
Self-hosted control plane for the Pis and Linux boxes you already SSH into — backups, patching, Compose, and an audit trail. Secrets in the database are encrypted; the master key stays on your disk.

接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Self-hosted control plane for the Pis and Linux boxes you already SSH into — backups, patching, Compose, and an audit trail. Secrets in the database are encrypted; the master key stays on your disk.

Secure fleet management for Raspberry Pi clusters. Backups, patching, and Docker control with zero plaintext secrets.
After 30+ years as an engineer, senior cybersecurity leader, tinkerer, hacker, and 3D designer/builder, I got tired of brittle bash scripts and manual processes across my Raspberry Pi clusters and homelab.
PiHerder was born the same way many great tools are: scripts that automate the boring stuff so I could focus on building and securing systems. It replaces manual workflows with an auditable web UI. Fleet secrets in the database are Fernet-encrypted; PIHERDER_MASTER_KEY stays in your host .env.
Inspired by projects like Nginx Proxy Manager — simple, powerful, self-hosted tools that just make life easier.
ha CLI check/apply, container patching with schedulestmux or screen so Hide keeps the shell on the PiPIHERDER_HOST_FILES)PIHERDER_SERVICE_MIGRATE=false to turn it off). Runs on the Celery worker. A failure after names flip can be undone. A finished Move has no Undo/piherder/ as a Lovelace resource). It pairs with PiHerder v1.13.0 and needs Home Assistant 2024.7 or newer. A read token is sensors and the card. jobs and edit add confirm actions, including host reboot. Agents use hosted POST /mcp, or the air-gapped piherder-mcp adapter 0.4.4 (list_alerts, prune_build_cache, replace_stale_mac, prune_docker, the backup schedule fields, start_move, read_discovery, start_discovery, and the LAN Discovery device tools). It also lists fleet_summary. The 1.13.0 image does not serve GET /api/v1/fleet/summary, so that tool returns 404 there. Volume prune stays on the Docker page. 0.4.3 does not list those four. A cached 0.4.3 needs uvx --refresh piherder-mcp, then a restart of the MCP client. list_alerts, prune_build_cache, and replace_stale_mac are in the 1.13.0 image.See the full Getting Started guide.
.env.example → .envPIHERDER_MASTER_KEY (critical)docker compose up -d (pulls multi-arch bjorngluck/piherder:latest)PiHerder is now open source under the MIT license. Contributions, issues, feature ideas, and PRs are very welcome.
See CONTRIBUTING.md for details.
If you find PiHerder useful, consider sponsoring the project or buying me a coffee — it helps fund continued development and infrastructure.
bjorngluck/piherder:1.13.0 · 1.13 · latest. Pin 1.12.1 stays that patch. Pin 1.12.0 stays that patch. Pin 1.11.1 / 1.11 is the previous minor image. Plugin 0.5.4. MCP adapter 0.4.4. Wiki: Backups · Self-backup · Agents (MCP) · Home Assistant.Explore the UI before installing: https://piherder-demo.hacknow.info
Shared viewer login — current username and password are on the wiki / Public demo page. The fleet is synthetic; there is no path to your machines. Limits and notes live on that wiki page.
FastAPI + SQLModel + PostgreSQL + Paramiko + cryptography (Fernet) + Jinja2 + compiled Tailwind + HTMX + Alpine + APScheduler + Celery.
Offline / air-gapped ready — Once built, the container has no external CDN dependencies. Tailwind utilities are compiled CSS (no Play / no eval).
MIT — see LICENSE.
Repository: github.com/bjorngluck/piherder
Secure fleet management for Raspberry Pi clusters. Backups, patching, and Docker control with zero plaintext secrets.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Piherder 透過 stdio 在本機執行。
上次檢查時間:2026-11-08。 Secure fleet management for Raspberry Pi clusters. Backups, patching, and Docker control with zero plaintext secrets.