Awesome Open Source
Awesome Open Source

Latest Version on Packagist Total Downloads

Laravel Server Monitor

Laravel package to periodically monitor the health of your server and application. It ships with common checks out of the box and allows you to add your own custom checks too. The packages comes with both console and web interfaces.


  • PHP >= 7+
  • Laravel 5+


$ composer require sarfraznawaz2005/servermonitor

Additional step for Laravel < 5.5:

Add Service Provider to config/app.php in providers section


Now publish package's config file by running below command:

$ php artisan vendor:publish --provider="Sarfraznawaz2005\ServerMonitor\ServiceProvider"

See config/server-monitor.php config file to customize checks, notifications and more.

Built-in Checks

The package comes with following checks out of the box. Checks can be divided into three categories:

  • Server Checks: Checks that are related to your server only.
  • Common Checks: Checks that are related to your application only but are common in nature irrespective of which environment your application is running on. These checks run on all environments.
  • Environment Checks: Checks that are related to your application only but are limited to specific environment such as production or development.

Server Checks

  • ✅ Required PHP extensions are installed
  • ✅ Disk Space Enough
  • ✅ Average CPU Usage
  • ✅ FTP Connection Works
  • ✅ SFTP Connection Works
  • ✅ SSL Certificate Valid
  • ✅ Are servers pingable
  • ✅ Check HTTP Status Code
  • ✅ Check php.ini file values

Common Checks

  • ✅ Correct PHP version installed
  • ✅ The environment file exists
  • ✅ APP_KEY is set
  • ✅ Correct Directory Permissions
  • ✅ Database can be accessed
  • ✅ Migrations are up to date
  • ✅ Composer dependencies up to date
  • ✅ Check Composer Packages Security
  • ✅ Storage directory is linked
  • ✅ The Redis cache can be accessed
  • ✅ Mail is Working
  • ✅ Cloud Storage Works
  • ✅ Config file has correct values

Environment Checks (Development)

  • ✅ Debug Mode ON
  • ✅ Config Cache OFF
  • ✅ Routes Cache OFF

Environment Checks (Production)

  • ✅ Debug Mode OFF
  • ✅ Config Cache ON
  • ✅ Routes Cache ON
  • ✅ Unwanted PHP extensions disabled
  • ✅ Supervisor programs are running


The package comes with two commands:

  • php artisan servermonitor:check Runs all checks enabled in config file and return their new status.
  • php artisan servermonitor:status Returns previously-run status of all checks without running new process.

Here is how it looks:

Screen 3

Both commands take optional argument. If specified, it will run check or return status of only specified check:

  • php artisan servermonitor:check AppKeySet Runs new check process for check AppKeySet
  • php artisan servermonitor:status AppKeySet Returns previous run status for check AppKeySet


You can use servermonitor:check command to check status of enabled checks periodically instead of running this command manually each time.

Schedule it in Laravel's console kernel file accordingly:

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)

Web Interface

The package provides built-in web interface. You can customize the route of web interface in config file 'route' => 'servermonitor'. Once done, you can visit Web Interface at url Replace servermonitor with route you used.

Other than commands, you can also use Web Interface to run new checks process for all or individual checks.

Screen 1

Screen 2

Disabling Web Interface

If you would like to disable Web Interface, you can set web_interface_enabled to false and now hitting web interface route would result in 404.

Running/Getting Checks Programmatically

If you still would like to show status of various checks in your view in your own way, you can get status of all checks programmatically like so:

use Sarfraznawaz2005\ServerMonitor\ServerMonitor;

$sm = new ServerMonitor();
$checkResults = $sm->getChecks();

You can also run check(s) programmatically ($sm->runChecks()), see available methods in file: vendor/Sarfraznawaz2005/ServerMonitor/src/ServerMonitor.php

Running Checks for Web Only

If for some reasons, you want to run some checks manually and via Web Interface only, you can specify web_only option for such checks like this:

\Sarfraznawaz2005\ServerMonitor\Checks\Server\RequiredPhpExtensionsAreInstalled::class => [
    'web_only' => true

Now above check will not be run via console when servermonitor:check is run. However this check will be performed when you run all checks via Web Interface.


See config/server-monitor.php file for all checks. Note that some checks are commented intentionally, you can un-comment them if you need to use them.

You can also customize check name that displays up in console/web interface by passing name config value like this:

\Sarfraznawaz2005\ServerMonitor\Checks\Application\AppKeySet::class => [
    'name' => 'Check if APP_KEY is set',

If you don't pass name key, it will be made out of class name, in above case App Key Set by automatically converting "PascalCase" to "Pascal Case" from class name.

Some checks may require additional config options such as:

\Sarfraznawaz2005\ServerMonitor\Checks\Application\ComposerDependenciesUpToDate::class => [
    'binary_path' => 'composer'

For above check to work, you must provide binary_path value for example.

Alert Configuration

You can get notified when a check fails. Package supports these alert/notification channels:

  • mail
  • log
  • slack
  • pushover

Update your notification options under notifications option in config file.

Note that you can also customize all notification options for individual checks too. Let's say you have specified mail as default channel for your alerts but for following check only, it will be alerted via log channel and a different alert title:

\Sarfraznawaz2005\ServerMonitor\Checks\Application\AppKeySet::class => [
    'notification_channel' => 'log',
    'notification_title' => 'Hello World'

You can also disable alerts for individual checks like so:

\Sarfraznawaz2005\ServerMonitor\Checks\Application\AppKeySet::class => [
    'disable_notification' => true

Creating Your Own Custom Checks

You can create custom checks, by implementing the [Sarfraznawaz2005\ServerMonitor\Checks\Check] interface and adding the class to the config file. Example:

use Sarfraznawaz2005\ServerMonitor\Checks\Check;

class MyCheck implements Check
     * Perform the actual verification of this check.
     * @param array $config
     * @return bool
    public function check(array $config): bool
        return 1 === 1;

     * The error message to display in case the check does not pass.
     * @return string
    public function message(): string
        return "This error message that users see if check returns false.";


Please let's know if you notice any issues, we recommend PRs for existing or new checks.

No Tests ?

We welcome PRs for test cases.



Please see the license file for more information.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Php (402,597) 
Laravel (12,988) 
Server (4,928) 
Monitor (1,051) 
Laravel Package (1,036) 
Health (821) 
Checker (507) 
Status (382) 
Related Projects
Advertising 📦 9
All Projects
Application Programming Interfaces 📦 120
Applications 📦 181
Artificial Intelligence 📦 72
Blockchain 📦 70
Build Tools 📦 111
Cloud Computing 📦 79
Code Quality 📦 28
Collaboration 📦 30
Command Line Interface 📦 48
Community 📦 81
Companies 📦 60
Compilers 📦 60
Computer Science 📦 74
Configuration Management 📦 39
Content Management 📦 167
Control Flow 📦 197
Data Formats 📦 77
Data Processing 📦 266
Data Storage 📦 132
Economics 📦 60
Frameworks 📦 198
Games 📦 122
Graphics 📦 103
Hardware 📦 148
Integrated Development Environments 📦 47
Learning Resources 📦 147
Legal 📦 28
Libraries 📦 119
Lists Of Projects 📦 21
Machine Learning 📦 336
Mapping 📦 61
Marketing 📦 15
Mathematics 📦 55
Media 📦 228
Messaging 📦 97
Networking 📦 304
Operating Systems 📦 84
Operations 📦 120
Package Managers 📦 52
Programming Languages 📦 229
Runtime Environments 📦 96
Science 📦 42
Security 📦 375
Social Media 📦 26
Software Architecture 📦 70
Software Development 📦 68
Software Performance 📦 57
Software Quality 📦 127
Text Editors 📦 45
Text Processing 📦 131
User Interface 📦 310
User Interface Components 📦 465
Version Control 📦 29
Virtualization 📦 68
Web Browsers 📦 38
Web Servers 📦 25
Web User Interface 📦 194