Configuration Hierarchy

The following diagram represents the hierarchy of the Apache configuration file includes as it is organized under the Panel management.

The following placeholders are used in configuration file names on the diagram:

• <version> designates the version of a configuration file. Versioning allows to roll back to using previous configuration in case the generated one contains errors.
• <domain-name> designates domain name of the website for which the configuration is generated.

The configuration files that the Panel generates automatically cannot be customized. These files are explained as follows:

• ~conf.d/zz010_psa_httpd.conf

  Serves as a main container including all configuration files generated by the Panel. Depending on the operating system, the file location is one of the following:

  • /etc/httpd/conf.d/zz010_psa_httpd.conf
  • /etc/apache2/conf.d/zz010_psa_httpd.conf
• /usr/local/psa/admin/conf/ip_vhosts_bootstrap.conf

  Bootstrap file for domains set as 'Default on IP address'.

• /usr/local/psa/admin/conf/vhosts_bootstrap.conf

  Bootstrap file for the rest of domains.

• /usr/local/psa/admin/conf/webmail_horde_bootstrap.conf

  Bootstrap file for domains that use Horde as webmail.

• /usr/local/psa/admin/conf/webmail_atmail_bootstrap.conf

  Bootstrap file for domains that use Atmail as webmail.

• /usr/local/psa/admin/conf/webmail_atmailcom_bootstrap.conf

  Bootstrap file for domains that use Atmail as webmail.

The configuration files that the Panel generates from templates can be customized, as explained in detail in the Configuration Customization section. The configuration files are explained as follows. For information on particular templates, refer to the Template Files section.

• /usr/local/psa/admin/conf/generated/<version>_server.include

  Server configuration; root template: server.php.

• /var/www/vhosts/<domain-name>/conf/<version>_httpd.include

  Website configuration for hosted websites or website forwardings; root template: domainVhost.php or domainForwarding.php.

• /usr/local/psa/admin/conf/generated/<version>_horde.include

  Server-wide Horde configuration; template: horde.php.

• /usr/local/psa/admin/conf/generated/<version>_atmail.include

  Server-wide Atmail configuration; template: atmail.php .

• /usr/local/psa/admin/conf/generated/<version>_atmailcom.include

  Server-wide Atmail Commerce configuration; template: atmailcom.php.

• /usr/local/psa/admin/conf/generated/<version>_<domain_name>_webmail.include

  Webmail service configuration for a website; template: domainWebmail.php.