HomeButler

HomeButler is a single Go binary for homelab servers that remembers what your infrastructure looked like last time and tells you what changed and what is…

  • Backup
  • Infrastructure
  • Monitoring & Logging
  • Tools & Utilities
HomeButler is a single Go binary for homelab servers that remembers what your infrastructure looked like last time and tells you what changed and what is worth acting on. Each run compares the current state against the most recent snapshot and produces a concise butler-style report covering health, warnings, notable changes, and suggested next commands, delivered via CLI, web dashboard, JSON, or Model Context Protocol (MCP). It is aimed at self-hosting hobbyists who want a narrative does-this-matter summary rather than a wall of dashboards.

Platform availability

Available on 3 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 11 days ago
Popular
50318 GitHub stars
Easy to install
453 install platforms, install notes
Light to run
No data
Security check
88no serious findings, 2 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
318
Open issues
4
Last commit
2026-11-10
Latest release
v1.6.0
License
MIT
Activity
declining

Checked 12 days ago - source: GitHub (Higangssh/homebutler)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Clear port 53 for Pi-hole/AdGuard If you install Pi-hole or AdGuard, clear port 53 (the port used for DNS, which turns names into network addresses), and on Linux stop the built-in `systemd-resolved` name-lookup service if it already uses that port. If port 53 is not free, ad blocking and ordinary name lookups can stop working. source
  • Change Nginx Proxy Manager's default login If you install Nginx Proxy Manager, change its default login immediately, since the docs show [email protected] / changeme. This is a gateway for your other apps, so a guessable password could let strangers reach them. source
  • Install via Homebrew On macOS or Linux, install with: brew install Higangssh/homebutler/homebutler — then run homebutler report to create the initial baseline. source
  • First-run baseline On first run HomeButler creates a baseline snapshot under ~/.homebutler/reports/snapshots/; later runs compare against the latest snapshot. Old snapshots are pruned automatically (--keep 30 by default). source

Fetched 12 days ago - each note links to its source

Alternatives (1)

  • Portainer - Portainer is a lightweight, open-source container management UI for Docker, Swarm, Podman, and Kubernetes environments.

Checked 12 days ago - source: AlternativeTo

Common questions

Where does HomeButler keep the snapshots it uses for run-to-run comparisons, and how long are they retained?

It stores snapshots under ~/.homebutler/reports/snapshots/ and compares later runs to the latest snapshot. Old snapshots are pruned automatically, with 30 kept by default.

What common port or credential problems does the HomeButler documentation point out for homelab apps?

It advises clearing port 53 for Pi-hole or AdGuard and stopping Linux systemd-resolved if it is using that port. It also tells users to change Nginx Proxy Manager's default admin login immediately.

Does HomeButler require a database or persistent processes on the machines it watches?

No, it is a single Go binary with no database and nothing running on the machines it watches.

Can I connect HomeButler to MCP-compatible tooling?

Yes, it includes a built-in MCP server.

Answers sourced from github.com, github.com, github.com

Community

Collected 12 days ago - public community threads