PHPackages spatie/uptime-monitor-app - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. spatie/uptime-monitor-app AbandonedArchivedProject[Mail & Notifications](/categories/mail) spatie/uptime-monitor-app ========================= A PHP application to monitor uptime and ssl certificates 2.0.0(9y ago)2191.0k35MITPHPPHP ^7.0 Since Dec 11Pushed 7y ago2 watchersCompare [ Source](https://github.com/spatie/uptime-monitor-app)[ Packagist](https://packagist.org/packages/spatie/uptime-monitor-app)[ RSS](/packages/spatie-uptime-monitor-app/feed)WikiDiscussions master Synced yesterday READMEChangelog (6)DependenciesVersions (7)Used By (0) A PHP application to monitor uptime and ssl certificates ======================================================== [](#a-php-application-to-monitor-uptime-and-ssl-certificates) [![Latest Version on Packagist](https://camo.githubusercontent.com/9b049e90aff58261afe40a521981ff418fec85c6047ff2306af6177a94470191/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f757074696d652d6d6f6e69746f722d6170702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/uptime-monitor-app)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/0fc121452670d8fb21d87742ceffe6ab201ac76f1db09f7c3368c4507159e054/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f757074696d652d6d6f6e69746f722d6170702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/uptime-monitor-app) `uptime-monitor-app` is a powerful, easy to configure uptime monitor written in PHP 7. It will notify you when one of your sites goes down (and when it comes back up). You can also be notified a few days before an SSL certificate on one of your sites expires. Out of the box you can be notified via mail or Slack. Here are some examples of how the Slack notifications look like: [![](https://camo.githubusercontent.com/b6dd7d002a92d1d9b47d4455dc391060bb1876fb262c6255de9a4da9d9d6f770/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f6d6f6e69746f722d6661696c65642e6a7067)](https://camo.githubusercontent.com/b6dd7d002a92d1d9b47d4455dc391060bb1876fb262c6255de9a4da9d9d6f770/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f6d6f6e69746f722d6661696c65642e6a7067) [![](https://camo.githubusercontent.com/e9e78f0071ed66154f09dd702ad34bb43b07b80d7bed938293631979b336b554/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f6d6f6e69746f722d7265636f76657265642e6a7067)](https://camo.githubusercontent.com/e9e78f0071ed66154f09dd702ad34bb43b07b80d7bed938293631979b336b554/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f6d6f6e69746f722d7265636f76657265642e6a7067) [![](https://camo.githubusercontent.com/006a8422531a768c7f6d2caacfe25f8b0b45f063eb70945302a1e22213dec9d0/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f73736c2d6578706972696e672d736f6f6e2e6a7067)](https://camo.githubusercontent.com/006a8422531a768c7f6d2caacfe25f8b0b45f063eb70945302a1e22213dec9d0/68747470733a2f2f646f63732e7370617469652e62652f696d616765732f757074696d652d6d6f6e69746f722f73736c2d6578706972696e672d736f6f6e2e6a7067) Under the hood the uptime-monitor is a vanilla Laravel 5.3 application with the [laravel-uptime-monitor](https://docs.spatie.be/laravel-uptime-monitor) installed into it. If you know your way around Laravel, it's recommended that you use [laravel-uptime-monitor](https://docs.spatie.be/laravel-uptime-monitor) instead of this app. Installation ------------ [](#installation) You can install the application by issuing this command: ``` composer create-project spatie/uptime-monitor-app ``` To complete your installation these steps must be performed: First you should add the following command to your cron table. It should run every minute: ``` php /artisan schedule:run ``` Secondly, specify a Slack webhook url in the `notifications.slack.url` key in `configuration.php` found in the installation directory. You can [create a new webhook url](https://my.slack.com/services/new/incoming-webhook/) on the Slack website. Configuration ------------- [](#configuration) The configuration file `configuration.php` is located inside the installation directory. Reading it is a good way to quickly get a feel of what `uptime-monitor-app` can do. Here's the content of the config file: ``` return [ /* * You can get notified when specific events occur. Out of the box you can use 'mail' * and 'slack'. Of course you can also specify your own notification classes. */ 'notifications' => [ 'notifications' => [ \Spatie\UptimeMonitor\Notifications\Notifications\UptimeCheckFailed::class => ['slack'], \Spatie\UptimeMonitor\Notifications\Notifications\UptimeCheckRecovered::class => ['slack'], \Spatie\UptimeMonitor\Notifications\Notifications\UptimeCheckSucceeded::class => [], \Spatie\UptimeMonitor\Notifications\Notifications\CertificateCheckFailed::class => ['slack'], \Spatie\UptimeMonitor\Notifications\Notifications\CertificateExpiresSoon::class => ['slack'], \Spatie\UptimeMonitor\Notifications\Notifications\CertificateCheckSucceeded::class => [], ], /* * The location from where you are running this Laravel application. This location will be * mentioned in all notifications that will be sent. */ 'location' => '', /* * To keep reminding you that a site is down, notifications * will be resent every given number of minutes. */ 'resend_uptime_check_failed_notification_every_minutes' => 60, 'mail' => [ 'to' => ['your@email.com'], ], 'slack' => [ 'webhook_url' => env('UPTIME_MONITOR_SLACK_WEBHOOK_URL'), ], /* * Here you can specify the notifiable to which the notifications should be sent. The default * notifiable will use the variables specified in this config file. */ 'notifiable' => \Spatie\UptimeMonitor\Notifications\Notifiable::class, /* * The date format used in notifications. */ 'date_format' => 'd/m/Y', ], 'uptime_check' => [ /* * When the uptime check could reach the url of a monitor it will pass the response to this class * If this class determines the response is valid, the uptime check will be regarded as succeeded. * * You can use any implementation of Spatie\UptimeMonitor\Helpers\UptimeResponseCheckers\UptimeResponseChecker here. */ 'response_checker' => Spatie\UptimeMonitor\Helpers\UptimeResponseCheckers\LookForStringChecker::class, /* * An uptime check will be performed if the last check was performed more than the * given number of minutes ago. If you change this setting you have to manually * update the `uptime_check_interval_in_minutes` value of your existing monitors. * * When an uptime check fails we'll check the uptime for that monitor every time `monitor:check-uptime` * runs regardless of this setting. */ 'run_interval_in_minutes' => 5, /* * To speed up the uptime checking process the package can perform the uptime check of several * monitors concurrently. Set this to a lower value if you're getting weird errors * running the uptime check. */ 'concurrent_checks' => 10, /* * The uptime check for a monitor will fail if the url does not respond after the * given number of seconds. */ 'timeout_per_site' => 10, /* * Because networks can be a bit unreliable the package can make three attempts * to connect to a server in one uptime check. You can specify the time in * milliseconds between each attempt. */ 'retry_connection_after_milliseconds' => 100, /* * Fire `Spatie\UptimeMonitor\Events\MonitorFailed` event only after * the given number of uptime checks have consecutively failed for a monitor. */ 'fire_monitor_failed_event_after_consecutive_failures' => 2, /* * When reaching out to sites this user agent will be used. */ 'user_agent' => 'spatie/laravel-uptime-monitor uptime checker', /* * When reaching out to the sites these headers will be added. */ 'additional_headers' => [], ], 'certificate_check' => [ /* * The `Spatie\UptimeMonitor\Events\SslExpiresSoon` event will fire * when a certificate is found whose expiration date is in * the next number of given days. */ 'fire_expiring_soon_event_if_certificate_expires_within_days' => 10, ], /* * To add or modify behaviour to the Monitor model you can specify your * own model here. The only requirement is that it should extend * `Spatie\UptimeMonitor\Models\Monitor`. */ 'monitor_model' => Spatie\UptimeMonitor\Models\Monitor::class, ]; ``` Basic usage ----------- [](#basic-usage) To start monitoring a url: ``` php artisan monitor:create ``` and answer the questions that are asked. If your url starts with `https://` the application will also monitor the ssl certificate. To stop monitoring a url issue this command: ``` php artisan monitor:delete ``` To list all monitors you can perform: ``` php artisan monitor:list ``` Advanced usage -------------- [](#advanced-usage) Under the hood the uptime-monitor is a vanilla Laravel 5.3 application with our [laravel-uptime-monitor](https://github.com/spatie/laravel-uptime-monitor) installed into it. Please refer to [it's extensive documentation](https://docs.spatie.be/laravel-uptime-monitor) to know more how to configure and use this application. By default the application will use a `sqlite` database located at `/database.sqlite` to store all monitors. Documentation ------------- [](#documentation) You'll find the documentation of the underlying `laravel-uptime-monitor` package on . Find yourself stuck using this app or the underlying package? Found a bug? Do you have general questions or suggestions for improving the uptime monitor? Feel free to [create an issue on GitHub](https://github.com/spatie/laravel-uptime-monitor/issues), we'll try to address it as soon as possible. Postcardware ------------ [](#postcardware) You're free to use this package (it's [MIT-licensed](LICENSE.md)), but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium. The best postcards will get published on the open source page on our website. Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [All Contributors](../../contributors) About Spatie ------------ [](#about-spatie) Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects [on our website](https://spatie.be/opensource). License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 37 — LowBetter than 81% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity34 Limited adoption so far Community19 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 87.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 6 Last Release 3445d ago Major Versions 0.0.2 → 1.0.02016-12-12 1.1.0 → 2.0.02017-01-24 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (35 commits)")[![levidurfee](https://avatars.githubusercontent.com/u/10798199?v=4)](https://github.com/levidurfee "levidurfee (1 commits)")[![ptondereau](https://avatars.githubusercontent.com/u/4287777?v=4)](https://github.com/ptondereau "ptondereau (1 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (1 commits)")[![Tjoosten](https://avatars.githubusercontent.com/u/5157609?v=4)](https://github.com/Tjoosten "Tjoosten (1 commits)")[![vmitchell85](https://avatars.githubusercontent.com/u/1248035?v=4)](https://github.com/vmitchell85 "vmitchell85 (1 commits)") --- Tags applicationmonitornotificationsphpslackupdateuptimespatielaravelcertificatesslmonitoruptime ### Embed Badge ![Health badge](/badges/spatie-uptime-monitor-app/health.svg) ``` [![Health](https://phpackages.com/badges/spatie-uptime-monitor-app/health.svg)](https://phpackages.com/packages/spatie-uptime-monitor-app) ``` ### Alternatives [pragmarx/health Laravel Server & App Health Monitor and Notifier 2.0k1.0M2](/packages/pragmarx-health)[spatie/laravel-failed-job-monitor Get notified when a queued job fails 1.1k2.8M4](/packages/spatie-laravel-failed-job-monitor)[spatie/laravel-notification-log Log notifications sent by your Laravel app 2081.0M](/packages/spatie-laravel-notification-log)[spatie/laravel-discord-alerts Send a message to Discord 154504.1k](/packages/spatie-laravel-discord-alerts)[spatie/laravel-mailcoach-sdk An SDK to easily work with the Mailcoach API in Laravel apps 41340.7k1](/packages/spatie-laravel-mailcoach-sdk)[daanra/laravel-lets-encrypt A Laravel package to easily generate SSL certificates using Let's Encrypt 22654.7k](/packages/daanra-laravel-lets-encrypt) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)