ZP

zepgram/pi-dashboard

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 1 forks Качество 81 Тренд 24MIT

Real-time Raspberry Pi monitoring dashboard: live metrics and history, Docker, service health, WireGuard, REST API and a built-in MCP server. One container, no database.

Обзор

Real-time monitoring dashboard for a Raspberry Pi home server (or any Linux box): one container, no database, a REST API and a built-in MCP server. - : CPU (per core, frequency, overclock), memory, temperature, load, disks, network rates, top processes. - : the last hour and the last 24 hours of CPU, memory, temperature, load and network, kept in memory and carried across restarts. - : under-voltage and throttling status, session min/max temperature. - : every container with state, health, CPU and memory, without enabling the memory cgroup. - : HTTP, HTTPS, TCP, Redis, DNS and network-interface checks, with auto-discovery of what listens on the host. - : connected clients, last handshake, transfer. - : configurable warning and critical thresholds, toast and optional sound. - protected by an API key, and an so an AI assistant can read the state of the machine. - : three densities (normal, compact, ultra for kiosks), five colour themes, keyboard shortcuts, installable on a phone.

README

Показан фрагмент оригинального README. Открыть оригинал.

Pi Dashboard

Real-time monitoring dashboard for a Raspberry Pi home server (or any Linux box): one container, no database, a REST API and a built-in MCP server.

Features

  • Live metrics: CPU (per core, frequency, overclock), memory, temperature, load, disks, network rates, top processes.
  • History: the last hour and the last 24 hours of CPU, memory, temperature, load and network, kept in memory and carried across restarts.
  • Raspberry Pi specifics: under-voltage and throttling status, session min/max temperature.
  • Docker: every container with state, health, CPU and memory, without enabling the memory cgroup.
  • Service health: HTTP, HTTPS, TCP, Redis, DNS and network-interface checks, with auto-discovery of what listens on the host.
  • WireGuard: connected clients, last handshake, transfer.
  • Alerts: configurable warning and critical thresholds, toast and optional sound.
  • REST API protected by an API key, and an MCP server so an AI assistant can read the state of the machine.
  • Interface: three densities (normal, compact, ultra for kiosks), five colour themes, keyboard shortcuts, installable on a phone. No external request: it works on a network without Internet access.
  • Settings are stored server-side and shared by every device.

Quick start (Docker)

The image is built for linux/arm64 and linux/amd64.

mkdir -p pi-dashboard/data && cd pi-dashboard
curl -O https://raw.githubusercontent.com/zepgram/pi-dashboard/main/docker-compose.yml
docker compose up -d

The dashboard is at http://your-pi-ip:3001.

services:
  pi-dashboard:
    image: usernamedigital/pi-dashboard:latest
    container_name: pi-dashboard
    restart: unless-stopped
    environment:
      - PORT=3001
      - SETTINGS_CONFIG=/app/data/settings.json
      - ADMIN_TOKEN=           # optional: protects configuration changes
      - CORS_ORIGINS=*
    volumes:
      - ./data:/app/data                               # settings, API key hash, history
      - /proc:/host/proc:ro                            # host metrics
      - /sys:/host/sys:ro
      - /:/host/root:ro                                # disks, OS release, pending updates
      - /var/run/docker.sock:/var/run/docker.sock:ro   # containers
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "pi-dashboard": { "type": "http", "url": "http://your-pi:3001/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }