geertmeersman/ha-fleet-monitor repository overview

⁠HA Fleet Monitor

A self-hosted dashboard to monitor and manage multiple Home Assistant instances from a single interface.

⁠Features

• 📊 Dashboard — Overview of all HA instances with status, version and available updates
• 🔧 Managed / Monitored — Split instances into managed (full control) and monitored (read-only)
• 📦 Update management — Install individual updates or all updates at once, sequentially per instance
• 🔄 Restart — Restart any managed HA instance directly from the dashboard
• ⚠️ Reboot required — Visual indicator when a restart is required
• 🛠️ Admin panel — Add, edit and remove instances via a web UI (stored in SQLite)
• 📧 Weekly email report — Automatic email every Monday at 08:00 with pending updates per instance
• 🧪 Test mode — Redirect all emails to a test recipient without affecting production
• 🔐 Authentication — Admin account setup on first run, password stored as hash in the database
• 🔑 Two-factor authentication — TOTP-based 2FA via any authenticator app
• 🔁 Password reset — Reset password via email link
• 💾 Export / Import — Export and import instance configuration as JSON
• 🔔 Attention favicon — Favicon blinks when updates or a reboot is required
• 🌗 Light / Dark theme — Theme toggle with system preference detection
• 🌐 Multilingual — EN / NL / FR / DE / ES

⁠Tags

⁠Quick start

Create a docker-compose.yml:

With reverse proxy (no exposed port):

services:
  ha-fleet-monitor:
    image: geertmeersman/ha-fleet-monitor:latest
    container_name: ha-fleet-monitor
    restart: unless-stopped
    volumes:
      - ./data:/data
    networks:
      - proxy

networks:
  proxy:
    external: true

Standalone (with exposed port):

services:
  ha-fleet-monitor:
    image: geertmeersman/ha-fleet-monitor:latest
    container_name: ha-fleet-monitor
    restart: unless-stopped
    volumes:
      - ./data:/data
    ports:
      - "5000:5000"

Then start:

docker compose up -d

The dashboard is available at the configured proxy URL, or at http://localhost:5000 when using the standalone setup.

On first run you will be redirected to /setup to create your admin account (email + password).

⁠Supported HA Setups

⁠Links

• 📖 Full documentation & source code⁠
• 🐛 Report an issue⁠
• 📋 Changelog⁠
• 📜 License — GPLv3⁠