webapp-config

Directory which holds the htdocs directory for your website.

By default, all websites are /var/www/fqdn, where fqdn 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.

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.