Include Editor

(Home >> Service Configuration >> Apache Configuration >> Include Editor)

This feature allows you to add other configuration files to your Apache configuration file (httpd.conf). This can be useful in “teaching” Apache how to handle new types of files and changing default Apache configurations globally or between virtual hosts.

Properly employing the Include command in the configuration file requires a few initial considerations.

First, you will need to decide where it will go. Using the WHM interface, select where, in the configuration file, the Include command should be used. You have 3 options.

• Pre Main — Earliest in the httpd.conf file. Use this option if you do not need to overwrite any part of the httpd.conf configuration file.
• Pre VirtualHost — Middle area of the httpd.conf file. Use this option if you need to modify a part of the httpd.conf configuration file, before virtual hosts are configured.
• Post VirtualHost — End of the httpd.conf file, after virtual hosts are configured. Use this option if you need to permanently modify a piece of the configuration file.

After choosing where in the httpd.conf file you would like to use Include, you need to select whether you wish to apply the Include to all versions of Apache or just your current version. Using the pull-down box next to the appropriate option, select the version of Apache you would like the Include to affect.

• By selecting your current version of Apache, your Include will be overwritten when Apache is updated. This is useful when you’re unsure whether a new version of Apache will support your Include statement.
• If you select All Versions from the pull-down menu, your Include statement will be kept for all future versions of Apache.

After you use the pull-down menu to select the affected version(s), a text box will appear. To add an include, type the Include statement into the appropriate box.

• You can choose to include a specific file or an entire directory.
  • Example: Include /etc/example.conf or Include /etc/example/.
  • If a directory is specified, the directory will be scanned for any configuration files. Any configuration files found inside that directory will be included with the statement.

Remember: Use the Update button to store the include statement to Apache’s configuration.