seba
/
mydocker
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mydocker/ha-dashboard
History
blasebast 9b069a15c4 docs: improve all README files, add uptime-kuma 2026-04-12 20:11:50 +02:00
..
auth .gitignore, documentation, other improvements 2026-04-04 21:45:48 +02:00
bin WIP: ha-dashboard, Prowlarr indexers, HA pyscript, log-ingester, watchdog 2026-04-09 12:03:08 +02:00
templates docs: improve all README files, add uptime-kuma 2026-04-12 20:11:50 +02:00
Dockerfile .gitignore, documentation, other improvements 2026-04-04 21:45:48 +02:00
README.md docs: improve all README files, add uptime-kuma 2026-04-12 20:11:50 +02:00
app.py Add pre-commit with detect-secrets, ignore gitea runtime data 2026-04-11 10:34:50 +02:00
requirements.txt .gitignore, documentation, other improvements 2026-04-04 21:45:48 +02:00

README.md

HA Dashboard - Operations Panel

Custom Flask application serving as the central operations dashboard for the entire home infrastructure. Aggregates data from Home Assistant, PostgreSQL, Docker and CrowdSec into a single view.

Access

Endpoint Details
Public URL https://hadash.sebson.space
Internal Port 9081 -> 8080
Auth Login required (registration with admin approval)

Configuration

  • Built locally from ./ha-dashboard/Dockerfile (Python 3.12-slim + Flask)
  • Dependencies: flask, psycopg2-binary, requests, docker
  • Environment: DB_HOST, DB_PORT, DB_USER, DB_PASS, HA_URL, HA_TOKEN, SECRET_KEY

Volumes

Mount Container Path Purpose
/var/run/docker.sock - Docker API access (container info, CrowdSec exec)
./backup.log /backup.log Database backup log
./ha-dashboard/auth/ /auth/ User authentication files
./homeassistant/config/ /ha_config/ HA device registry, ZigBee database

Architecture

HA Dashboard (Flask)
  ├── Home Assistant REST API  - entity states, automations, logbook
  ├── PostgreSQL 18            - homeassistant & bitwarden DB sizes
  ├── Docker socket            - container list, exec into crowdsec
  ├── /ha_config/zigbee.db     - ZigBee DB (last_seen, LQI)
  └── /backup.log              - PostgreSQL backup history

API Endpoints

Endpoint Description
/ Main dashboard (SPA)
/api/overview People at home, open windows/doors, temperatures, Mazda status, backup
/api/home Gate state, gate automations, light list with brightness
/api/power Current power consumption (main clamp, NAS, Shelly, Tasmota)
/api/frigate Last 9 Frigate detections (images proxied)
/api/automations HA automation stats, recently triggered
/api/containers All Docker container statuses
/api/crowdsec Active bans and recent alerts
/api/db Database sizes and top 10 tables
/api/bitwarden Vaultwarden stats (password count by type)
/api/zigbee ZigBee devices with last_seen, LQI and battery level
/api/gate/events Gate open events from PostgreSQL
/api/gate/logbook Gate logbook and automations from HA API
/api/scene/all_lights_off Trigger "all lights off" scene
/api/toggle/<entity_id> Toggle any HA entity

Authentication

Two-step: user registers at /register, account requires manual admin approval (creation of file at auth/approved/<username>). Flask sessions keyed by SECRET_KEY.

Approving a User

# Approve a pending user
touch ./ha-dashboard/auth/approved/<username>

# List pending users
ls ./ha-dashboard/auth/pending/

Useful Commands

# Rebuild after code changes
docker compose build ha-dashboard && docker compose up -d ha-dashboard

# Follow logs
docker compose logs -f ha-dashboard