How to Add Custom Settings in WHM/cPanel Apache VirtualHost

    RahulBy 2 Mins Read

    While using WHM/cPanel, We can not make any changes directly in Apache configuration file. This file is automatically created by cPanel templates and re-created on system reboot or WHM update. Any Custom changes will be lost during recreation of Apache configuration file.

    But If we want to add own custom configuration in Apache configuration of any websites VirtualHost, We can do it by creating configuration file at /usr/local/apache/conf/userdata/std/2_2/<username>/<sitename.com>/extra.conf. In other versions this location may change. So to find this location, check website VirtualHost in main configuration file, at the end of VirtualHost you will get location like below

    # To customize this VirtualHost use an include file at the following location
# Include "/usr/local/apache/conf/userdata/ssl/2_2/myuser/mydomain.com/*.conf"

    How to do:

    Now use the following commands to create directory structure and configuration file. Change myuser with your actual cPanel username and change mydomain.com with actual domain name for which you want to add custom settings.

    # mkdir -p /usr/local/apache/conf/userdata/ssl/2_2/myuser/mydomain.com/
# cd /usr/local/apache/conf/userdata/ssl/2_2/myuser/mydomain.com/

    Now create configuration file with any name but with .conf extension

    # vim extra.conf

    Put your custom settings in extra.conf file and execute following command from shell. This command will uncomment “Include “/usr/local/apache/conf/userdata/ssl/2_2/myuser/mydomain.com/*.conf” line in VirtualHost of main apache configuration file.

    # /scripts/ensure_vhost_includes --all-users

    And all done. By this way you will not loose any custom changes for your VirtualHost.

    Share.

    Related Posts

    2 Comments

    1. Manjeet Seewooth on

      HEllo,

      Suppose i want to raise the proxytimeout of a vhost , in the /etc/apache2/conf.d/userdata/ssl/2_4/user/account/extra.conf i just add :
      ProxyTimeout 30s ,
      will it consider the change ? or i should add ;

      SetHandler proxy:unix:/opt/cpanel/ea-php72/root/usr/var/run/php-fpm/9e52de05db715a5d60427be56982097f8f20f39c.sock|fcgi://testgo.mips.mu
      ProxyTimeout 30s

      Reply
    2. Nick Fenwick on

      Thank you for this post, I just wanted to expand on it. As you say, the reason the conf file you refer to is read by Apache is that it is Included from httpd.conf, e.g.:

      ServerName servername.com
      …
      Include “/usr/local/apache/conf/userdata/ssl/2_2/username/servername.com/*.conf”

      The ‘ssl’ in the conf file path refers to the fact that this is port 443 configuration and so is intended for . Requests to will look for config in /usr/local/apache/conf/userdata/std/2_2/username/servername.com/*.conf.

      I believe the ‘2_2’ in the path refers to Apache httpd verion 2.2. If you are using 2.4 this part of the path may also change.

      I hope this helps people running into this and trying something slightly different 🙂

      Reply

    Leave A Reply