Data HUD

A local web application for orchestrating a personal data stack for practice or study. Start, stop, and monitor Docker services from a browser dashboard. Query databases without opening a million windows. Live your best life.

Prerequisites

• Docker Desktop (with Compose v2)
• Node.js ≥ 18

Getting Started

1. Install dependencies

npm install

2. Start the dev servers

npm run dev

• Frontend → http://localhost:5173
• Backend API → http://localhost:3001

3. Start the Docker stack

npm run stack:up

Stop with:

npm run stack:down

Services

Service	URL / Port	Notes
MongoDB	localhost:27017
ZooKeeper	localhost:2181	Kafka dependency
Kafka	localhost:9092 (internal), 29092 (external)
Kafka Connect	http://localhost:8083	REST API
kafka-ui	http://localhost:8080	Web UI
Airflow	http://localhost:8081	admin / admin
SeaweedFS (master)	http://localhost:9333
SeaweedFS (filer)	http://localhost:8887
SeaweedFS (S3)	http://localhost:8333	S3-compatible API
Polaris	http://localhost:8182	Iceberg REST catalog
Spark	http://localhost:8082	Web UI; RPC on 7077
PostgreSQL	localhost:5432	postgres / postgres
ClickHouse	http://localhost:8123	Native on 9000; default / clickhouse
Druid	http://localhost:8888	Web console

Project Structure

data-hud/
├── backend/          # Express API (TypeScript)
├── frontend/         # React + Vite dashboard (TypeScript)
└── docker/
    └── compose.yml   # Full data stack definition