Homy

Self-hosted status board. Monitor your services in real time with a clean, minimal UI.

Features

• Add/remove services (name, URL, icon)
• Auto-ping every 60s with 10-minute history
• Visual ping bars showing latency
• Status banner: operational / degraded / major incident
• Drag-and-drop reordering
• Icon picker (Simple Icons)
• Mobile-friendly

Quick start

docker run -d \
  -p 3000:3000 \
  -e DATA_DIR=/app/data \
  -v ./data:/app/data \
  ghcr.io/ddrayko/homy

Open http://localhost:3000.

Docker Compose

services:
  homy:
    image: ghcr.io/ddrayko/homy
    container_name: homy
    ports:
      - "3000:3000"
    environment:
      - DATA_DIR=/app/data
    volumes:
      - ./data:/app/data
    restart: unless-stopped

docker compose up -d

Note: DATA_DIR must be set to /app/data so data files are written inside the mounted volume. Without it, services and ping history are stored inside the container and lost on recreate.

Build from source

git clone https://github.com/ddrayko/homy.git
cd homy
docker build -t homy .
docker run -d -p 3000:3000 homy

Update

Docker Compose:

docker compose pull && docker compose up -d --force-recreate

Docker Run:

docker pull ghcr.io/ddrayko/homy
docker stop homy && docker rm homy
docker run -d \
  -p 3000:3000 \
  -e DATA_DIR=/app/data \
  -v ./data:/app/data \
  --restart unless-stopped \
  --name homy \
  ghcr.io/ddrayko/homy

Development

npm install
node server.js

Tech

• Node.js + Express backend
• Vanilla JS frontend
• Docker / GHCR distribution

License

MIT

---