PHPackages                             eightcedars/filament-inactivity-guard - 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. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. eightcedars/filament-inactivity-guard

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

eightcedars/filament-inactivity-guard
=====================================

Gracefully auto-logout users from idle/inactive Filament sessions

1.1.0(4mo ago)2464.8k↓18.2%5[2 PRs](https://github.com/eightcedars/filament-inactivity-guard/pulls)2MITPHPPHP ^8.1CI passing

Since Jan 29Pushed 1w agoCompare

[ Source](https://github.com/eightcedars/filament-inactivity-guard)[ Packagist](https://packagist.org/packages/eightcedars/filament-inactivity-guard)[ Docs](https://github.com/eightcedars/filament-inactivity-guard)[ GitHub Sponsors](https://github.com/eightcedars)[ RSS](/packages/eightcedars-filament-inactivity-guard/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (1)Dependencies (9)Versions (13)Used By (2)

Filament idle/inactive session guard
====================================

[](#filament-idleinactive-session-guard)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6a154ad9c9c479a9606f7c58bb4ad4bf5a4d3e61e9c1330a54699943972736a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65696768746365646172732f66696c616d656e742d696e61637469766974792d67756172642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eightcedars/filament-inactivity-guard)[![GitHub Tests Action Status](https://camo.githubusercontent.com/73c7fb78df8ec7ba2500b7b61f55b67240aff4dd5ad16358a42be567f453d9f7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f65696768746365646172732f66696c616d656e742d696e61637469766974792d67756172642f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/eightcedars/filament-inactivity-guard/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/18e5dc3dfc1d18a4bbfa5d565e651686195a4b755488a236b9b02931693c1c54/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f65696768746365646172732f66696c616d656e742d696e61637469766974792d67756172642f6669782d7068702d636f64652d7374796c696e672e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/eightcedars/filament-inactivity-guard/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/1d713a2a44d8ab4ae1bb1be66d7050e28c4c583c141440a8f18ef391a08e1088/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65696768746365646172732f66696c616d656e742d696e61637469766974792d67756172642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eightcedars/filament-inactivity-guard)

Guard your Filament dashboard from inactive sessions. Log users out after a predefined period of inactivity.

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

[](#installation)

You can install the package via composer:

```
composer require eightcedars/filament-inactivity-guard
```

You can publish the config file with:

```
php artisan vendor:publish --tag="filament-inactivity-guard-config"
```

This is the contents of the published config file:

```
return [
     /**
     * Determine if the plugin is enabled
     */
    'enabled' => true,

    /**
     * How long to wait before an idle session is considered inactive.
     * This value must be in seconds
     */
    'inactivity_timeout' => Carbon::SECONDS_PER_MINUTE * env('FILAMENT_IDLE_TIMEOUT', 15),

    /**
     * How long to show an inactive session notice before logging the user out.
     * This value must be in seconds
     *
     * Set this to null or 0 to disable the notice and log out immediately a user's session becomes inactive
     */
    'notice_timeout' => env('FILAMENT_IDLE_WARNING_TIMEOUT', 60),

    /**
     * This package watches for a list of browser events to determine if a user is still active.
     * You may customise as desired.
     *
     * Ensure that the list is not empty
     */
    'interaction_events' => ['mousemove', 'keydown', 'click', 'scroll'],
];
```

Optionally, you can publish the translation files using

```
php artisan vendor:publish --tag="filament-inactivity-guard-translations"
```

You can also publish the view files using

```
php artisan vendor:publish --tag="filament-inactivity-guard-views"
```

Usage
-----

[](#usage)

Add the plugin class to your panel ServiceProvider

```
use EightCedars\FilamentInactivityGuard\FilamentInactivityGuardPlugin;

$panel
    ...
    ->plugin(FilamentInactivityGuardPlugin::make())
    ...
```

You may also configure the plugin behaviour in your service provider instead of publishing and editing the config file:

```
use EightCedars\FilamentInactivityGuard\FilamentInactivityGuardPlugin;use Illuminate\Support\Carbon;$panel
    ...
    ->plugin(
        FilamentInactivityGuardPlugin::make()
            ->inactiveAfter(Carbon::SECONDS_PER_MINUTE * 5)
            ->showNoticeFor(Carbon::SECONDS_PER_MINUTE * 1)
            // Or set to null to logout immediately after inactivity
            ->showNoticeFor(null)

            ->enabled(!app()->isLocal())
            ->keepActiveOn(['change', 'select', 'mousemove'], mergeWithDefaults: true),
    )
    ...
```

You can configure the timeout settings using the following environment variables:

VariableDefaultDescription`FILAMENT_IDLE_TIMEOUT``15` minutesInactivity period before the logout warning dialog is displayed.`FILAMENT_IDLE_WARNING_TIMEOUT``60` secondsDuration the logout warning is displayed before the user is automatically logged out.Screenshots
-----------

[](#screenshots)

[![](https://raw.githubusercontent.com/eightcedars/filament-inactivity-guard/main/screenshots/inactivity-notice.png)](https://raw.githubusercontent.com/eightcedars/filament-inactivity-guard/main/screenshots/inactivity-notice.png)[![](https://raw.githubusercontent.com/eightcedars/filament-inactivity-guard/main/screenshots/loggedout-notice.png)](https://raw.githubusercontent.com/eightcedars/filament-inactivity-guard/main/screenshots/loggedout-notice.png)

Available Languages
-------------------

[](#available-languages)

🇸🇦 Arabic (`ar`) · 🇧🇩 Bengali (`bn`) · 🇨🇳 Chinese (Simplified) (`zh_CN`) · 🇹🇼 Chinese (Traditional) (`zh_TW`) · 🇩🇰 Danish (`da`) · 🇳🇱 Dutch (`nl`) · 🇬🇧 English (`en`) · 🇮🇷 Farsi / Persian (`fa`) · 🇫🇮 Finnish (`fi`) · 🇫🇷 French (`fr`) · 🇩🇪 German (`de`) · 🇮🇱 Hebrew (`he`) · 🇮🇳 Hindi (`hi`) · 🇮🇸 Icelandic (`is`) · 🇮🇩 Indonesian (`id`) · 🇮🇹 Italian (`it`) · 🇯🇵 Japanese (`ja`) · 🇰🇷 Korean (`ko`) · 🇲🇾 Malay (`ms`) · 🇳🇴 Norwegian (`no`) · 🇵🇱 Polish (`pl`) · 🇧🇷 Portuguese (Brazil) (`pt_BR`) · 🇷🇺 Russian (`ru`) · 🇪🇸 Spanish (`es`) · 🇸🇪 Swedish (`sv`) · 🇹🇭 Thai (`th`) · 🇹🇷 Turkish (`tr`) · 🇺🇦 Ukrainian (`uk`) · 🇻🇳 Vietnamese (`vi`)

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [EightCedars](https://github.com/eightcedars)
- [Emmanuel Nelson](https://github.com/eyounelson)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance88

Actively maintained with recent releases

Popularity42

Moderate usage in the ecosystem

Community18

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 58.3% 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 ~54 days

Recently: every ~82 days

Total

8

Last Release

139d ago

Major Versions

0.4.0 → 1.0.02025-09-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/129889629?v=4)[EightCedars](/maintainers/eightcedars)[@eightcedars](https://github.com/eightcedars)

---

Top Contributors

[![eyounelson](https://avatars.githubusercontent.com/u/24621192?v=4)](https://github.com/eyounelson "eyounelson (21 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![Israel5](https://avatars.githubusercontent.com/u/63180786?v=4)](https://github.com/Israel5 "Israel5 (1 commits)")[![olivsinz](https://avatars.githubusercontent.com/u/29924640?v=4)](https://github.com/olivsinz "olivsinz (1 commits)")

---

Tags

autologoutfilament-pluginlaravelfilamentphpfilament auto logouteightcedarsfilament inactivity guardfilament idle session

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/eightcedars-filament-inactivity-guard/health.svg)

```
[![Health](https://phpackages.com/badges/eightcedars-filament-inactivity-guard/health.svg)](https://phpackages.com/packages/eightcedars-filament-inactivity-guard)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6649.5k1](/packages/marcelweidum-filament-passkeys)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[solution-forest/filament-email-2fa

filament-email-2fa

3211.0k](/packages/solution-forest-filament-email-2fa)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16120.1k](/packages/backstage-mails)[waguilar33/filament-guardian

Role and permission management for Filament

162.3k](/packages/waguilar33-filament-guardian)

PHPackages © 2026

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