Manual: a2dissite
A2ENSITE(8) System Manager's Manual A2ENSITE(8)
NAME
a2ensite, a2dissite - enable or disable an apache2 site / virtual host
SYNOPSIS
a2ensite [-q|--quiet] [-m|--maintmode] [ site ]
a2dissite [-q|--quiet] [-m|--maintmode] [-p|--purge] [ site ]
DESCRIPTION
This manual page documents briefly the a2ensite and a2dissite commands.
a2ensite is a script that enables the specified site (which contains a block) within the apache2 conโ
figuration. It does this by creating symlinks within /etc/apache2/sites-enabled. Likewise, a2dissite disables a
site by removing those symlinks. It is not an error to enable a site which is already enabled, or to disable one
which is already disabled.
Apache treats the very first virtual host enabled specially as every request not matching any actual directive is beโ
ing redirected there. Thus it should be called 000-default in order to sort before the remaining hosts to be loaded
first.
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
a2ensite and a2dissite exit with status 0 if all sites are processed successfully, 1 if errors occur, 2 if an invalid
option was used.
EXAMPLES
a2dissite 000-default
Disables the default site.
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/sites-available
Directory with files giving information on available sites.
/etc/apache2/sites-enabled
Directory with links to the files in sites-available for enabled sites.
SEE ALSO
apache2ctl(8), a2enmod(8), a2dismod(8), a2enconf(8), a2disconf(8).
AUTHOR
This manual page was written by Stefan Fritsch (based on the a2enmod manual page by Daniel Stone
) for the Debian GNU/Linux distribution.
8 June 2007 A2ENSITE(8)