Sign inSign up

espiralvex/statusmon

By espiralvex

•Updated 5 months ago

Web pages status monitor with anonymous federation between users

Image
0

2.1K

espiralvex/statusmon repository overview

⁠StatusMon

Self-hosted uptime monitor. Track response time, TTFB, SSL expiry and server stats without depending on any external service.

No database · No registration · No telemetry · MIT license

GitHub Docker Pulls Image Size


⁠Quick start

docker run -d \
  --name statusmon \
  --restart unless-stopped \
  -p 3000:3000 \
  -v /opt/statusmon/data:/data \
  -v /proc:/host/proc:ro \
  espiralvex/statusmon:latest

Open http://YOUR-IP:3000/admin⁠ → set your password → add sites.


⁠Docker Compose

services:
  statusmon:
    image: espiralvex/statusmon:latest
    container_name: statusmon
    restart: unless-stopped
    environment:
      - PORT=3000
      - DATA_DIR=/data
    ports:
      - "3000:3000"
    volumes:
      - /opt/statusmon/data:/data
      - /proc:/host/proc:ro
docker compose up -d

⁠ZimaOS — App Store → Custom Install

Paste this YAML in App Store → ⊞ Custom Install:

services:
  statusmon:
    image: espiralvex/statusmon:latest
    container_name: statusmon
    restart: unless-stopped
    environment:
      - PORT=3000
      - DATA_DIR=/data
    ports:
      - target: 3000
        published: "${WEBUI_PORT:-3000}"
        protocol: tcp
    volumes:
      - $HOME/AppData/statusMon:/data
      - /proc:/host/proc:ro

x-casaos:
  main: statusmon
  title:
    en_us: StatusMon
  category: Network
  index: /admin
  port_map: "${WEBUI_PORT:-3000}"

⁠Platforms

PlatformSupport
linux/amd64✅ x86-64 (VPS, NAS, server)
linux/arm64✅ Raspberry Pi 4/5, Apple M-series (Rosetta)
linux/arm/v7✅ ZimaBlade, ZimaBoard, older Raspberry Pi

⁠Data

All data is stored in the bind-mounted /data directory on the host. Never delete this directory — it contains your config, history, SMTP credentials and push subscriptions.

/data/
├── config.json       # App settings
├── sites.json        # Monitored sites
├── history.json      # Check history (up to 7 days)
├── .secret           # AES-256 key (auto-generated)
├── .jwtsecret        # JWT key (auto-generated)
├── .vapid.json       # Web Push keys (auto-generated)
└── releases/         # Applied update ZIPs

⁠Environment variables

VariableDefaultDescription
PORT3000Container port
DATA_DIR/dataData directory inside container

All other settings (check interval, alerts, SSL, etc.) are configured from the admin panel and saved in /data/config.json.


⁠Features

  • HTTP/HTTPS, TCP, DNS, Heartbeat monitors
  • Response time, TTFB, SSL expiry tracking
  • 7-day history with time-range selector (1h/6h/24h/7d/custom)
  • P50/P75/P95/P99 stats, uptime 24h/7d/total, MTBF, trend
  • Email alerts (Gmail, Outlook, iCloud presets or direct SMTP)
  • Web Push native notifications (VAPID, no third-party)
  • Server stats: CPU, RAM, disk, load average, temperature
  • In-app updates: upload ZIP from admin panel, no SSH needed
  • PWA installable on mobile and desktop
  • No database — all state in JSON files

⁠Source

github.com/8aws/statusmon⁠ · MIT License

Tag summary

Content type

Image

Digest

sha256:d06efb9b6…

Size

49.8 MB

Last updated

5 months ago

docker pull espiralvex/statusmon