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.

Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
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.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Piherder läuft lokal über stdio.
Zuletzt geprüft: 2026-11-08. Secure fleet management for Raspberry Pi clusters. Backups, patching, and Docker control with zero plaintext secrets.