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 <VirtualHost> block) within the apache2 configuration. 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 being 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 example, 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 <sf@debian.org> (based on the a2enmod manual page by Daniel Stone <daniel@sfarc.net>) for the Debian GNU/Linux distribution.