How to Use Apache Includes to Add Configuration Directives to a Specific Domain's VirtualHost

This article provides a guide for how to use Apache includes to add configuration directives to a specific domain's VirtualHost. This article explains how to add your custom directives to a single domain's VirtualHost, inside the VirtualHost context. This guide requires root level access to the cPanel VPS or cPanel Dedicated Server.

Apache configuration directives have certain contexts associated with them. The contexts that are associated with a directive determine where a directive can exist. For more information about Apache's Contexts, please see their documentation:

Contexts | Apache Documentation

There are some Apache directives that need to be set within the VirtualHost context. If you need to add a directive to the VirtualHost context, you would need to use the method described in this article to do so.

How to Use Apache Includes to Add Configuration Directives to a Specific Domain's VirtualHost

You'll need root access, either via SSH or the WHM Terminal to complete this task.

  1. as the root user, or log into WHM as root and navigate to Terminal.
  2. Issue the following commands, replacing CPANELUSERNAME and DOMAIN.TLD as appropriate for your situation. Additionally, the "include" in "include.conf" can be changed, but the files are loaded in alphabetical order. The username and domain portion are in all capital letters in this example to highlight what needs to be changed, but make sure to use all lowercase letters when running the commands on your server:
    mkdir -p /etc/apache2/conf.d/userdata/ssl/2_4/CPANELUSERNAME/DOMAIN.TLD/
    mkdir -p /etc/apache2/conf.d/userdata/std/2_4/CPANELUSERNAME/DOMAIN.TLD/
    touch /etc/apache2/conf.d/userdata/ssl/2_4/CPANELUSERNAME/DOMAIN.TLD/include.conf
    touch /etc/apache2/conf.d/userdata/std/2_4/CPANELUSERNAME/DOMAIN.TLD/include.conf
  3. Edit the newly created files so they contain your desired directives.
  4. Rebuild the Apache configuration to add the includes with this command:
    /usr/local/cpanel/scripts/rebuildhttpdconf
  5.  Restart Apache so it reads the new configuration:
    /usr/local/cpanel/scripts/restartsrv_httpd

Conclusion

You now know how to use Apache includes to add configuration directives to a specific domain's VirtualHost.

  • apache, apache directives, virtualhost, virtual hosts
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Disable Network Manager on CentOS 7

This article will provide the steps to disable Network Manager in CentOS 7. Network Manager is...

Disable Network Manager on CentOS 6

This article will provide the steps to disable Network Manager in CentOS 6. Network Manager is...

How to Find the IP of cPanel/WHM Server

This tutorial is designed to troubleshoot and diagnose issues with cPanel license errors. Find...

Uninstall WHMXtra on cPanel Server

This article provides a quick and direct guide for uninstalling the WHMXtra plugin from a...

How to Customize cPanel Installation

This article provides a guide for customizing a cPanel server installation, using the...