cPanel & WHM no longer develops or updates EasyApache 3. We deprecated EasyApache 3 on December 31, 2018. We removed support for EasyApache 3 in cPanel & WHM version 78.
Apache Module: AuthnDBD - EasyApache - cPanel Documentation
Page tree
Skip to end of metadata
Go to start of metadata


The mod_authn_dbd Apache module provides the functionality for Apache to authenticate users with an SQL database. This module works in conjunction with a front-end Apache authentication module.


Use the mod_authn_dbd Apache module if you want Apache to authenticate users with an SQL database.


Front-end Apache authentication module

The mod_authn_dbd Apache module requires a front-end Apache authentication module. EasyApache includes the mod_auth_basic front-end authentication Apache module by default.

For information on the mod_auth_basic Apache module, click the following links:

EasyApache can also provide the mod_auth_digest Apache front-end authentication module. For information on how to enable this module, read our Apache Module: AuthDigest documentation.

SQL database

You can install the mod_authn_dbd module before you configure an SQL database. However, you must have an SQL database that includes user information to use the module.


This module has no known compatibility issues.

How to install or uninstall mod_authn_dbd

The EasyApache profiles do not provide the mod_authn_dbd Apache module by default.

To install or uninstall the mod_authn_dbd Apache module, perform the following steps:

  1. Run EasyApache in WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3).


    • To access EasyApache from the command line interface, run the /scripts/easyapache script as the root user.
    • For more information on EasyApache, read our EasyApache documentation.
  2. Select the profile that you wish to modify.

  3. Click the  icon that corresponds to your selection.

  4. Click Next Step in the Apache Version stage.
  5. Click Next Step in the PHP Version stage.
  6. Click Exhaustive Options List in the Short Options List stage.
  7. Perform one of the following actions in the Exhaustive Options List stage:
    • To install the mod_authn_dbd Apache module, select the AuthnDBD option.
    • To uninstall the mod_authn_dbd Apache module, deselect the AuthnDBD option.
  8. Click Save and Build.

How to enable or disable the module in a custom EasyApache profile file

The following table provides information about how EasyApache refers to the mod_authn_dbd Apache module: 

EasyApache module namemod_authn_dbd
EasyApache Profile EntryApache::optmods::AuthnDBD

To enable or disable the mod_authn_dbd Apache module in a custom EasyApache profile file, set the Apache::optmods::AuthnDBD profile entry to one of the following values:

  • 1 – This value enables the module.
  • 0 – This value disables the module.


The following table provides information on changes to the mod_authn_dbd Apache module within EasyApache, and content changes to this document:

DateEasyApache versionActionDetails
2/11/20143.24.11Doc updateImplemented case 73225: Remove Apache 1.3 and 2.0
1/31/20133.18.0Doc updateImplemented case 51105: Update for Apache 2.4

Related documentation

Apache authentication and authorization

For more information on Apache authentication and authorization, click the following links:

Apache authorization modules

The following table includes the Apache authorization modules that are available in EasyApache:

EasyApache optionEasyApache's documentationApache's documentation
AuthzDBMApache Module: AuthzDBM
AuthnzLDAPApache Module: AuthnzLDAP

Apache authentication modules

The following table includes the Apache authentication modules that are available in EasyApache:

EasyApache optionEasyApache's documentationApache's documentation
AuthnDBDApache Module: AuthnDBD
AuthnAnonApache Module: AuthnAnon


Apache Module: AuthnAlias


The mod_authn_alias Apache module does not provide authentication. It allows you to configure aliases to refer to authentication provider modules.

AuthnDBMApache Module: AuthnDBM
AuthnDefaultApache Module: AuthnDefault
AuthnzLDAPApache Module: AuthnzLDAP