Manual: a2disconf
A2ENCONF(8) System Manager's Manual A2ENCONF(8)
NAME
a2enconf, a2disconf - enable or disable an apache2 configuration file
SYNOPSIS
a2enconf [-q|--quiet] [-m|--maintmode] [ configuration ]
a2disconf [-q|--quiet] [-m|--maintmode] [-p|--purge] [ configuration ]
DESCRIPTION
This manual page documents briefly the a2enconf and a2disconf commands.
a2enconf is a script that enables the specified configuration file within the apache2 configuration. It does this by
creating symlinks within /etc/apache2/conf-enabled. Likewise, a2disconf disables a specific configuration part by
removing those symlinks. It is not an error to enable a configuration which is already enabled, or to disable one
which is already disabled.
Note that many configuration file may have a dependency to specific modules. Unlike module dependencies, these are
not resolved automatically. Configuration fragments stored in the conf-available directory are considered non-essen‐
tial or being installed and manged by reverse dependencies (e.g. web scripts).
OPTIONS
-q, --quiet
Don't show informative messages.
-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
a2enconf and a2disconf exit with status 0 if all configurations are processed successfully, 1 if errors occur, 2 if
an invalid option was used.
EXAMPLES
a2enconf security
a2disconf charset
Enables Apache security directives stored in the security configuration files, and disables the charset configura‐
tion.
ENVIRONMENT
The following environment variables may be specified.
dir_suffix
Distinguish different instances of apache2. Suffixes /etc/apache2 to build a new APACHE_CONFDIR
APACHE_CONFDIR
Override the entire configuraation directory (/etc/apache2$dir_suffix)
APACHE_ENVVARS
Override the default envvars file (/etc/apache2$dir_suffix/envvars)
APACHE_{MODS,CONF,SITES}_AVAIL
Override the path to the directory holding the available snippets for modules, configuration and sites.
APACHE_{MODS,CONF,SITES}_ENABLED
Override the path to the directory holding the enabled snippets for modules, configuration and sites. For ex‐
ample, in a multi-instance setup, you can set dir_suffix=-myinstance and override APACHE_MODS_AVAIL back to
/etc/apache2/mods-available to have a single store of snippets for all instances
APACHE_STATE_DIRECTORY
Override the path to the state directory (/var/lib/apache2)
FILES
/etc/apache2/conf-available
Directory with files giving information on available configuration files.
/etc/apache2/conf-enabled
Directory with links to the files in conf-available for enabled configuration files.
SEE ALSO
apache2ctl(8), a2enmod(8), a2dismod(8), a2ensite(8), a2dissite(8).
AUTHOR
This manual page was written by Arno Toell for the Debian GNU/Linux distribution, as it is a De‐
bian-specific script with the package.
14 February 2012 A2ENCONF(8)