Table of Contents
webapp-config — Configuration file for the webapp-config(8) tool
/etc/vhosts/webapp-config
/etc/vhosts/webapp-config contains the default settings for the webapp-config(8) installer tool.
Directory which holds the htdocs directory for your website.
By default, all websites are /var/www/, where fqdnfqdn is the full hostname of the website (e.g. www.gentoo.org). If you are putting your websites somewhere else, you must update vhost_root to suit.
You can use the value of vhost_hostname in your definition of vhost_root.
Default value when webapp-config's -h switch hasn't been used.
By default, this is set to the full hostname of your computer. If this hasn't been set correctly, then this is set to localhost instead.
The value of vhost_hostname
is splitted at each dot and the resulting domain name
parts are stored in sequentially
numbered vhost_subdomain_N
variables (e.g. www.test.org
results
in vhost_subdomain_1=org, vhost_subdomain_2=test,
etc.).
You may not set these variables yourself since they
are generated internally
by webapp-config. But you can use
them within the configuration file. So if you want to
have fine grained control over the location the web
applications get installed, you can
set vhost_root="/var/www/${vhost_subdomain_1}/${vhost_subdomain_2}/${vhost_subdomain_3}"
Default value when webapp-config's -s switch hasn't been used.
By default, this is set to apache, which is the webserver that most people use.
Overiding parameter for the server-dependant hardcoded uid which specifies the user to own all files and directories that are server-owned.
Warning: webapp-config's -s switch does not overide this parameter.
By default, this is disabled.
This can be either the name of a user or their numerical user id.
Overiding parameter for the server-dependant hardcoded gid which specifies the group to own all files and directories that are server-owned.
Warning: webapp-config's -s switch does not overide this parameter.
By default, this is disabled.
This can be either the name of a group or their numerical group id.
Default value when webapp-config's -u switch hasn't been used.
By default, this is set to the username of the user who is running webapp-config. At the time of writing, webapp-config only works for the root user, because only the root user is allowed to change the ownership of files and directories on disk.
This can be either the name of a user or their numerical user id.
Default value when webapp-config's -g switch hasn't been used.
By default, this is set to the primary group of the user who is running webapp-config.
This can be either the name of a group or their numerical group id.
Default value when webapp-config's --virtual-files switch hasn't been used.
By default, files which can be shared are hardlinked in. The virtual install does not get a local copy of the file, which normally prevents the web server or non-root users from editing the file.
Default user to own all files and directories that aren't server-owned or config-owned.
Default group to own all files and directories that aren't server-owned or config-owned.
Default values for the basename of the DocumentRoot.
webapp-config installs into vhost_root/vhost_htdocs_insecure by default. If you use the --secure switch, webapp-config installs into vhost_root/vhost_htdocs_secure instead.
Default filesystem permissions for directories and files that are installed as 'server-owned'.
Default filesystem permissions for directories and files that are installed as 'config-owned'.
Default filesystem permissions for directories that are installed as 'default-owned'. Note that it is not possible to install files that are 'default-owned'.
Default filesystem permissions for directories and files that are installed as 'virtual'.
Default filesystem permissions for the directory that webapp-config installs the package into.
webapp.eclass(5), webapp-config(8)
webapp-config is based on the design for an installer for web-based applications first defined in GLEP #11 for the Gentoo Linux project.