a2enmod(8)

a2enmod8

Enable or disable an apache2 module

Usage

a2enmod [{-q | --quiet}] [{-m | --maintmode}] [module]

a2dismod [{-q | --quiet}] [{-f | --force}] [{-m | --maintmode}] [{-p | --purge}] [module]

Overview

This manual page documents briefly the a2enmod and a2dismod commands.

a2enmod is a script that enables the specified module within the apache2 configuration. It does this by creating symlinks within /etc/apache2/mods-enabled. Likewise, a2dismod disables a module by removing those symlinks. It is not an error to enable a module which is already enabled, or to disable one which is already disabled.

Note that many modules have, in addition to a .load file, an associated .conf file. Enabling the module puts the configuration directives in the .conf file as directives into the main server context of apache2.

Options

-q, --quiet

Don't show informative messages.

-f, --force

When disabling a module, also cascade disables all modules that depends on it.

-m, --maintmode

Enables the maintainer mode, that is the program invocation is effectuated automatically by a maintainer script. This switch should not be used by end users.

-p, --purge

When disabling a module, purge all traces of the module in the internal state data base.

Exit status

a2enmod and a2dismod exit with status 0 if all modules are processed successfully, 1 if errors occur, 2 if an invalid option was used.

Examples

a2enmod imagemap
a2dismod mime_magic

Enables the mod_imagemap module, and disables the mod_mime_magic module.

Files

/etc/apache2/mods-available

Directory with files giving information on available modules.

/etc/apache2/mods-enabled

Directory with links to the files in mods-available for enabled modules.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 4 times.

  1. 3.1
  2. 4.0–6.0
  3. 7
  4. 8–10
  5. 11–13

--force since Debian 11 (Bullseye); --maintmode since Debian 8 (Jessie); --purge since Debian 8 (Jessie); --quiet since Debian 8 (Jessie); -f since Debian 11 (Bullseye); -m since Debian 8 (Jessie); -p since Debian 8 (Jessie); -q since Debian 8 (Jessie).

Author

This manual page was written by Daniel Stone <[email protected]> for the Debian GNU/Linux distribution, as it is a Debian-specific script with the package.

From apache2 2.4.68-1~deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's man source.