Manual: a2ensite

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)