Title: User Documentation – Block Administrator
Author: Immanuel Raj
Published: May 22, 2025
Last modified: July 23, 2025

---

# User Documentation – Block Administrator

**Overview:** Block Administrator is a security enhancement application for the **
Frappe Framework**. It blocks login attempts to the **administrator account** when
email‐password authentication is enabled, reducing the risk of unauthorized access
and improving **Frappe admin security**.

## Key Features for ERPNext Administrator Login Protection

 * **Enhanced Security:** Prevents unauthorized administrator logins.
 * **Zero Configuration:** Works out-of-the-box without additional setup.
 * **Seamless Integration:** Integrates natively with **Frappe’s authentication**
   system.

## How to Install Block Administrator in Frappe

### 1. Prerequisites

Ensure you have a working **Frappe** environment ready.

### 2. Install the App

    ```wp-block-code
    bench get-app block_administrator
    bench --site your-site-name install-app block_administrator
    ```

### 3. Restart Bench

    ```wp-block-code
    bench restart
    ```

## Usage – Blocking Admin Logins in ERPNext

Once installed, **Block Administrator** automatically blocks login attempts to the
administrator account when email‐password authentication is enabled. No further 
configuration is required, making it a lightweight and effective **Frappe admin 
security** tool.

## Support & Frappe Authentication Troubleshooting

Need help? Visit our [Support Page](https://immanuelraj.dev/block-administrator-support/)
or contact us at [support@immanuelraj.dev](https://immanuelraj.dev/user-documentation-block-administrator/support@immanuelraj.dev?output_format=md).

## Contributing to Block Administrator

We welcome contributions! See our [Contributing Guidelines](https://github.com/iamimmanuelraj/block_administrator/blob/develop/CONTRIBUTING.md)
to get started.