unclesamwk/tinymon repository overview

⁠TinyMon

The minimalist alternative to Prometheus, Nagios & Co. Pull checks. Push API. One SQLite file. Zero overhead.

⁠Quick Start

docker run -d \
  --name tinymon \
  -p 8080:80 \
  -e ADMIN_PASSWORD=changeme \
  -v tinymon-data:/var/www/html/data \
  unclesamwk/tinymon:latest

Open http://localhost:8080/backend and log in.

Add a cronjob for the check runner:

* * * * * docker exec tinymon php bin/runner.php >> /dev/null 2>&1

⁠Features

• Pull checks: Ping, HTTP, TCP Port, SSL Certificate, Content, Content Hash, Disk, Load, Memory
• Push API: External systems push results via REST API (K8s, cronjobs, CI/CD, IoT) with config-aware multi-check support
• Push-only checks: Disk Health (S.M.A.R.T.)
• Alerting: Email (SMTP) + Browser Push (VAPID) on status transitions
• Dashboard: Mobile-first PWA, charts, dark mode, multi-language (EN/DE)
• Zero dependencies: SQLite database, no agents required

⁠Supported Architectures

Multi-arch images -- works on x86 servers and ARM (Raspberry Pi, Apple Silicon, AWS Graviton).

⁠Environment Variables

⁠Volumes

⁠Docker Compose

services:
  tinymon:
    image: unclesamwk/tinymon:latest
    ports:
      - "8080:80"
    volumes:
      - tinymon-data:/var/www/html/data
    environment:
      - ADMIN_PASSWORD=changeme
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=your_user
      - SMTP_PASSWORD=your_password
      - [email protected]
      - [email protected]

volumes:
  tinymon-data:

⁠Push API Example

curl -X POST https://mon.example.com/api/push/results \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host_address": "web-1", "check_type": "backup", "status": "ok", "value": 42, "message": "Backup completed in 42s"}'

⁠Ecosystem

⁠Source Code

GitHub: unclesamwk/TinyMon⁠

⁠License

MIT