Search by

jorisnoo / statamic-license-health-check

jorgenoo

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

Statistics

Installs: 102

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.0 2026-11-19 05:25 UTC

This package is auto-updated.

Last update: 2026-11-19 05:26:14 UTC


README

Latest Version on Packagist GitHub Tests Action Status Total Downloads

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.