# webapp-config

## Reference

webapp-config

5

webapp-config

Configuration file for the

webapp-config

8 tool

    /etc/vhosts/webapp-config

#### Description

`/etc/vhosts/webapp-config` contains the default settings for the

webapp-config

8 installer tool.

#### Settings

vhost_root

- 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`.

vhost_hostname

- 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.

vhost_subdomain_{1,2,3...}

- 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}"

vhost_server

- 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.

vhost_server_uid

- 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.

vhost_server_gid

- 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.

vhost_config_uid

- 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.

vhost_config_gid

- 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.

vhost_config_virtual_files

- 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.

vhost_default_uid

- Default user to own all files and directories that aren't server-owned or config-owned.

vhost_default_gid

- Default group to own all files and directories that aren't server-owned or config-owned.

vhost_htdocs_insecure

vhost_htdocs_secure

- 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.

vhost_perms_serverowned_dir

vhost_perms_serverowned_file

- Default filesystem permissions for directories and files that are installed as 'server-owned'.

vhost_perms_configowned_dir

vhost_perms_configowned_file

- Default filesystem permissions for directories and files that are installed as 'config-owned'.

vhost_perms_defaultowned_dir

- Default filesystem permissions for directories that are installed as 'default-owned'. Note that it is not possible to install files that are 'default-owned'.

vhost_perms_virtual_dir

vhost_perms_virtual_file

- Default filesystem permissions for directories and files that are installed as 'virtual'.

vhost_perms_installdir

- Default filesystem permissions for the directory that `webapp-config` installs the package into.

#### See Also

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.