README

⭐ Found this useful? Give it a star on GitHub! It helps us maintain and improve the project.

Symfony bundle for synthetic uptime monitoring (Uptime Kuma–style): scheduled checks, detail retention, perpetual aggregates, multi-tenant dashboard with polling sync, public status page, and notifications.

📋 Compatible with Symfony 7.4+ and 8.x (PHP 8.2+)

Features

• ✅ HTTP/HTTPS, TCP, DNS, SSL certificate, and Ping (ICMP) checks
• ✅ Symfony Scheduler + nowo:uptime:run-due-checks
• ✅ Doctrine entities: tenant, monitor, check result, aggregates, incidents
• ✅ YAML retention (detail_days) + aggregates kept forever
• ✅ REST summary API for dashboard polling (?since= delta support)
• ✅ Vite + TypeScript dashboard and Chart.js charts
• ✅ Public status page per tenant (/status/{tenantSlug})
• ✅ Email, webhook, Slack notifications (on status change)
• ✅ CRUD for monitors and tenants (Twig UI)
• ✅ Demo Symfony 7 and 8 (FrankenPHP) — see docs/DEMO-FRANKENPHP.md
• ✅ Mercure real-time dashboard sync (dashboard.sync: mercure)

Quick start

composer require nowo-tech/uptime-monitor-bundle

# config/packages/nowo_uptime_monitor.yaml
nowo_uptime_monitor:
    retention:
        detail_days: 30

php bin/console nowo:uptime:sync-schema
php bin/console nowo:uptime:seed-demo
php bin/console nowo:uptime:run-due-checks

Dashboard: /uptime/{tenantSlug} · Status page: /status/{tenantSlug} (default tenant main).

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Changelog
• Upgrading
• Release process
• Security
• Engram
• Spec-driven development

Additional documentation

• Scheduling
• Check types
• Monitor configuration (Uptime Kuma parity)
• Tenant settings (Uptime Kuma parity)
• Translations (en, es)
• Notifications
• Mercure real-time sync
• Demo with FrankenPHP

Development

make up
make test
make assets
make -C demo up-symfony8

Tests and coverage

make test
make test-coverage
make test-coverage-90
make test-ts
make release-check

License

MIT — see LICENSE.