PHPackages                             mkwebdesign/filament-watchdog - 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. [Logging & Monitoring](/categories/logging)
4. /
5. mkwebdesign/filament-watchdog

ActiveLibrary[Logging & Monitoring](/categories/logging)

mkwebdesign/filament-watchdog
=============================

Advanced security monitoring and intrusion detection plugin for FilamentPHP

v1.0.3(11mo ago)8471↓90%[1 issues](https://github.com/MKWebDesign/filament-watchdog/issues)MITPHPPHP ^8.2

Since Jul 18Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/MKWebDesign/filament-watchdog)[ Packagist](https://packagist.org/packages/mkwebdesign/filament-watchdog)[ RSS](/packages/mkwebdesign-filament-watchdog/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (6)Versions (5)Used By (0)

 [![FilamentWatchdog Logo](https://raw.githubusercontent.com/mkwebdesign/filament-watchdog/main/art/logo.png)](https://raw.githubusercontent.com/mkwebdesign/filament-watchdog/main/art/logo.png)

FilamentWatchdog
================

[](#filamentwatchdog)

 **Advanced security monitoring and intrusion detection plugin for FilamentPHP**

 [ ![Latest Version on Packagist](https://camo.githubusercontent.com/67164074544aadd28120b8ad2dd846de6d24d8fb8966ea2795d0a86854e8458a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6b77656264657369676e2f66696c616d656e742d7761746368646f672e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/mkwebdesign/filament-watchdog) [ ![Total Downloads](https://camo.githubusercontent.com/2fa59861f0051f52b9a4623171dea52b76ff13453106266a6da2b120ecd16816/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6b77656264657369676e2f66696c616d656e742d7761746368646f672e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/mkwebdesign/filament-watchdog) [ ![License](https://camo.githubusercontent.com/7b18443167d0b68fcc754a75f51d20cec9a0e0ccb0f562709336e1be72e4d3f9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6b77656264657369676e2f66696c616d656e742d7761746368646f672e7376673f7374796c653d666c61742d737175617265) ](https://github.com/mkwebdesign/filament-watchdog/blob/main/LICENSE.md)

---

Features
--------

[](#features)

🛡️ **Real-time Protection**

- Real-time file integrity monitoring
- Automated malware detection with signature scanning
- Activity logging and anomaly detection

🚨 **Alert System**

- Email alerts for security events
- Customizable notification thresholds
- Real-time dashboard notifications

🔍 **Forensic Tools**

- Detailed forensic analysis tools
- Quarantine system for suspicious files
- Emergency lockdown system

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require mkwebdesign/filament-watchdog:^1.0
```

Publish the configuration file:

```
php artisan vendor:publish --tag=filament-watchdog-config
```

Optionally, publish the views (if you want to customize them):

```
php artisan vendor:publish --tag=filament-watchdog-views
```

Then run the auto-installer script from your Laravel root directory:

```
bash install-filament-watchdog.sh
```

And migrate the database:

```
php artisan migrate
```

Configuration
-------------

[](#configuration)

After publishing the config file, you can customize the settings in `config/filament-watchdog.php`:

```
return [
    'monitoring' => [
        'enabled' => true,
        'scan_interval' => 'everyMinute', // How often to run scans
    ],
    'alerts' => [
        'email' => [
            'enabled' => true,
            'recipients' => ['admin@yoursite.com'],
        ],
    ],
    'emergency' => [
        'auto_publish_views' => true,
        'lockdown_enabled' => true,
    ],
    // ... more settings
];
```

### Cronjob Setup (Required)

[](#cronjob-setup-required)

FilamentWatchdog requires the Laravel scheduler to run automated security scans. Add the standard Laravel cronjob to your server:

```
# Edit your crontab
crontab -e

# Add this line (standard Laravel scheduler - runs every minute)
* * * * * cd /path/to/your/laravel/project && php artisan schedule:run >> /dev/null 2>&1
```

**Example with full path:**

```
* * * * * php /home/username/domains/yoursite.com/public_html/artisan schedule:run >> /dev/null 2>&1
```

> **Note:** This is the standard Laravel scheduler cronjob that should run every minute. FilamentWatchdog will automatically schedule its security scans within this framework.

**Manual scan commands:**

```
# Run file integrity scan
php artisan watchdog:scan-integrity

# Run malware detection scan
php artisan watchdog:scan-malware

# Create new file baseline
php artisan watchdog:create-baseline

# Run complete security scan
php artisan watchdog:scan-all
```

### Panel Registration

[](#panel-registration)

Register the plugin in your `AdminPanelProvider`:

```
use MKWebDesign\FilamentWatchdog\FilamentWatchdogPlugin;

// Inside the panel() method:
->plugin(FilamentWatchdogPlugin::make());
```

Usage
-----

[](#usage)

After installation, visit:

```
/admin/security/dashboard

```

to access the security monitoring interface.

### Key Features:

[](#key-features)

- **Security Dashboard** - Overview of system security status
- **File Monitoring** - Real-time detection of file changes
- **Malware Scanner** - Automated scanning for malicious files
- **Alert System** - Email notifications for security events
- **Emergency Lockdown** - Immediate site protection in case of threats
- **Quarantine System** - Safe isolation of suspicious files

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- Laravel 10.x or 11.x
- FilamentPHP 3.x
- Cronjob access on your server

Troubleshooting
---------------

[](#troubleshooting)

### Config Not Published?

[](#config-not-published)

If the configuration file doesn't appear in `config/filament-watchdog.php`, try:

```
# Clear caches first
php artisan config:clear
php artisan cache:clear

# Then publish again
php artisan vendor:publish --tag=filament-watchdog-config --force

# Verify the file exists
ls -la config/filament-watchdog.php
```

### Cronjob Not Working?

[](#cronjob-not-working)

1. Check if the Laravel scheduler is configured correctly
2. Verify the path to your Laravel project in the cronjob
3. Ensure PHP is in your server's PATH
4. Check cronjob logs: `grep CRON /var/log/syslog`

### Permission Issues?

[](#permission-issues)

Make sure the web server user has write permissions to:

- `storage/app/` directory
- `storage/logs/` directory
- `storage/app/quarantine/` directory

Support
-------

[](#support)

Need help? Feel free to:

- Open an issue on [GitHub](https://github.com/mkwebdesign/filament-watchdog/issues)
- Contact us directly via email

Author
------

[](#author)

**Martin Knops | MKWebDesign**

- Website:
- Email:
- GitHub: [@mkwebdesign](https://github.com/mkwebdesign)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

---

 Made with ❤️ by [MKWebDesign](https://mkwebdesign.nl)

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance50

Moderate activity, may be stable

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

4

Last Release

339d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8e33b70bd1fd0970214803766cfce2166d5de818721b19c7283092102eb84955?d=identicon)[MKWebDesign](/maintainers/MKWebDesign)

---

Top Contributors

[![MKWebDesign](https://avatars.githubusercontent.com/u/1301187?v=4)](https://github.com/MKWebDesign "MKWebDesign (8 commits)")

---

Tags

monitoringsecurityfilamentmalwareintrusion-detection

### Embed Badge

![Health badge](/badges/mkwebdesign-filament-watchdog/health.svg)

```
[![Health](https://phpackages.com/badges/mkwebdesign-filament-watchdog/health.svg)](https://phpackages.com/packages/mkwebdesign-filament-watchdog)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

87411.3M152](/packages/spatie-laravel-health)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[flarum/core

Delightfully simple forum software.

201.4M2.2k](/packages/flarum-core)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1232.2k16](/packages/fleetbase-core-api)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)