PHPackages                             genaker/free-admin - 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 & Authorization](/categories/authentication)
4. /
5. genaker/free-admin

ActiveMagento2-module[Authentication & Authorization](/categories/authentication)

genaker/free-admin
==================

Magento 2 module that allows free admin login when env.php backend => auth = false

5(9mo ago)331[1 PRs](https://github.com/Genaker/FreeAdmin/pulls)MITPHP

Since Aug 20Pushed 3mo agoCompare

[ Source](https://github.com/Genaker/FreeAdmin)[ Packagist](https://packagist.org/packages/genaker/free-admin)[ RSS](/packages/genaker-free-admin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

Genaker FreeAdmin Module
========================

[](#genaker-freeadmin-module)

Overview
--------

[](#overview)

This module allows free admin login when the Magento\_Backend module is disabled in `app/etc/config.php`.

How It Works
------------

[](#how-it-works)

The module uses a before plugin on `Magento\Backend\Model\Auth::login()` method to:

1. **Security Check**: Never bypass authentication in production mode
2. Check if `Magento_Backend` module is disabled using Magento's `ModuleList` and `DeploymentConfig` classes
3. If disabled AND not in production mode, bypass normal authentication by:
    - First trying to find admin user by the provided email/username
    - If not found, falling back to the first available admin user
4. If enabled or in production mode, proceed with normal authentication

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

[](#installation)

### Method 1: Manual Installation

[](#method-1-manual-installation)

1. Copy the module to `app/code/Genaker/FreeAdmin/`
2. Enable the module: ```
    php bin/magento module:enable Genaker_FreeAdmin
    ```
3. Run setup: ```
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
    ```

### Method 2: Composer Installation

[](#method-2-composer-installation)

1. Add the module to your project's `composer.json`: ```
    {
        "repositories": [
            {
                "type": "path",
                "url": "app/code/Genaker/FreeAdmin"
            }
        ]
    }
    ```
2. Install via Composer: ```
    composer require genaker/free-admin:1.0.0
    ```
3. Run setup: ```
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
    ```

Usage
-----

[](#usage)

### To Enable Free Admin Access:

[](#to-enable-free-admin-access)

1. Set `backend/auth` to `false` in your deployment configuration (e.g., `app/etc/env.php`):

```
'backend' => [
    'auth' => false
],
```

2. Clear caches:

```
php bin/magento cache:flush
```

3. Now any username/password combination will work for admin login

### To Disable Free Admin Access:

[](#to-disable-free-admin-access)

1. Set `backend/auth` to `true` or remove the configuration in your deployment configuration:

```
'backend' => [
    'auth' => true
],
```

2. Clear caches:

```
php bin/magento cache:flush
```

Security Warning
----------------

[](#security-warning)

⚠️ **IMPORTANT**: This module is for development/testing purposes only.

- **Never bypasses authentication in production mode** - additional safety measure
- It bypasses authentication when enabled by using existing admin users
- Requires at least one admin user to exist in the system
- Only works in development or default modes

Module Structure
----------------

[](#module-structure)

```
Genaker/FreeAdmin/
├── Plugin/
│   └── Backend/
│       └── Model/
│           └── Auth/
│               └── SimpleLoginPlugin.php
├── etc/
│   ├── di.xml
│   └── module.xml
├── composer.json
├── registration.php
└── README.md

```

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

[](#troubleshooting)

### Module Not Working

[](#module-not-working)

1. Check if module is enabled: `php bin/magento module:status Genaker_FreeAdmin`
2. Verify plugin is loaded: `php bin/magento setup:di:compile`
3. Clear caches: `php bin/magento cache:flush`
4. We need also disable TWO FACTOR Auth modules

Customization
-------------

[](#customization)

To modify the authentication bypass logic, edit `SimpleLoginPlugin.php` in the `beforeLogin` method.

Support
-------

[](#support)

For issues or questions, check the module logs or contact the development team.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance71

Regular maintenance activity

Popularity7

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

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

272d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2614da2cb514a3749cd296d237c9ca3430f4dafa09b4e49e338a6b1794a5acf4?d=identicon)[genaker](/maintainers/genaker)

### Embed Badge

![Health badge](/badges/genaker-free-admin/health.svg)

```
[![Health](https://phpackages.com/badges/genaker-free-admin/health.svg)](https://phpackages.com/packages/genaker-free-admin)
```

###  Alternatives

[bitexpert/magento2-force-customer-login

The Force Login module for Magento2 redirects a storefront visitor to the Magento2 Frontend login page, if the visitor is not logged in. It is possible to configure the whitelisted urls to add custom definitions.

171409.9k](/packages/bitexpert-magento2-force-customer-login)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[space48/magento2-sso

SAML based single sign-on integration for Magento 2 backend.

1827.3k](/packages/space48-magento2-sso)[mage-os/module-admin-activity-log

The Admin Activity extension makes it easy to track all admin activity with comprehensive audit logging.

261.4k](/packages/mage-os-module-admin-activity-log)[o2ti/sigep-web-carrier

O2TI - Sigep Web Carrier

141.5k](/packages/o2ti-sigep-web-carrier)

PHPackages © 2026

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