jorisnoo / statamic-license-health-check
Monitor Statamic license validity without alerting on temporary Outpost outages.
Package info
github.com/jorisnoo/statamic-license-health-check
Language:Python
Type:statamic-addon
pkg:composer/jorisnoo/statamic-license-health-check
Requires
- php: ^8.3
- illuminate/support: ^12.0 || ^13.0
- spatie/laravel-health: ^1.40
- statamic/cms: ^6.0
Requires (Dev)
- laravel/pint: ^1.24
- mockery/mockery: ^1.6
- orchestra/testbench: ^10.0 || ^11.0
- phpunit/phpunit: ^11.0 || ^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 05:26:14 UTC
README
A production health check for Statamic licenses, built for spatie/laravel-health and Oh Dear.
The check fails on invalid Statamic or addon licenses. A connection error, HTTP 429, or HTTP 5xx from Outpost skips the check and records the reason and code. Other request errors, an unreadable license key file, and responses with no license verdict warn instead of claiming the license is invalid. Check the application log if the licensing response could not be processed.
Installation
composer require 'jorisnoo/statamic-license-health-check:^0.1.0'
The health check is discovered automatically and registered in production environments.
To keep a skipped check from producing HTTP 503 on Spatie's simple health endpoint, or a failure status on its JSON endpoint when json_results_failure_status is configured, set the following in config/health.php. This setting does not change the HTML results page.
'treat_skipped_as_failure' => false,
Migrating from an in-app check or dev-main
If a provider registers a check named StatamicLicenses during registration or boot, the package leaves it in place. Remove the old registration and class to switch to the packaged check. To keep full control of registration (including checks registered later), set 'register_statamic_licenses_check' => false in config/health.php. Rebuild the configuration cache when deploying that change.
Replace a dev-main constraint by running the installation command above; review and commit the consuming application's updated Composer lock file.
Testing
composer test
License
The MIT License. See LICENSE.md.
Maintainer releases
See RELEASING.md for versioning, changelog entries and the release command.