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…
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
Variants
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
- Show HN: Homebutler – Nightly restore drills for your homelab backups (forum)
- Show HN: Homebutler – Verify your backups restore, automatically (forum)
- Show HN: Homebutler – I manage my homelab from chat. AI never gets raw shell (forum)
- Show HN: Homebutler – AI manages your homelab without getting shell access (forum)
- Show HN: Homebutler – Self-healing homelab in a single Go binary (forum)
- Show HN: I replaced Portainer and btop with a single Go binary for my homelab (forum)
Collected 12 days ago - public community threads
