Skip to content
Robert Einsle edited this page Nov 17, 2026 · 3 revisions

Tech stack

  • PHP 8.5, Laravel 13, Filament 5
  • PostgreSQL in production, SQLite for local development and tests
  • laravel/passkeys for passkey login, pear/net_dns2 for DNS queries (including DNSSEC and the AD flag)
  • Docker image built with GitHub Actions and published to GitHub Container Registry, deployed with Coolify
  • Tests with PHPUnit

Architecture in short

  • Each check is a class in app/Checks that implements the common Check interface and returns a CheckOutcome (status, messages, details, fingerprint).
  • All checks are registered in App\Services\CheckRegistry. A new check is added there and in the CheckType enum; nothing else calls a check directly.
  • DomainChecker::evaluate() runs the registered checks without storing anything; the scheduled run and the DNS check page both use it.
  • Results several checks need (e.g. the STARTTLS certificate for the MX and DANE checks) are shared through CheckContext::cached() within one run.
  • DomainChecker runs the registered checks for a domain, ChangeDetector compares the run with the previous one, and AlertNotifier sends the mail.

Documentation

This handbook (handbuch/ in the repository) is the source of the wiki. The website gives an overview.

Contributing

Ideas, feature requests and bug reports are welcome as issues.

Clone this wiki locally