# 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 worth acting on.

Canonical page: https://ourlocalhost.com/app/7574/homebutler

## Description

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: Mac, Linux, Any server.

## Desktop and other devices

Mac, Linux.

## Health score

75/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 50 (318 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Official website: https://homebutler.dev
- GitHub: https://github.com/Higangssh/homebutler
- desktop: https://github.com/Higangssh/homebutler/releases/latest

## 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.

## Alternatives

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

---
Source: Our Local Host (https://ourlocalhost.com/app/7574/homebutler), the self-hosted and open-source app directory.
