Last modified: November 29, 2022

Overview

You can use the /usr/local/cpanel/scripts/fix-web-vhost-configuration script to iterate through each users web virtual host configuration files and remove excess alias names. Certain historical errors in cPanel & WHM make it possible for discrepancies to exist between what the system expects and the actual configuration.

This script performs the following actions:

1. Identify any unrecognized alias domains.

2. Delete the following unrecognized alias domains from the web virtual host configuration files:

   • Active service subdomains - cpanel.example.com

   • www subdomains of active service subdomains - www.cpanel.example.com

   • www subdomains of any expected alias - www.mail.example.com

     Note:

     This will ignore other unrecognized alias domains

      

3. Identify and add any missing alias domains.

Run the script

To run this script on the command line, use the following format:

/usr/local/cpanel/scripts/fix-web-vhost-configuration [arguments]

Options

Use the following options with this script:

Example

For example, the following command removes the excess alias name from the username cPanel users web virtual host configuration files:

/usr/local/cpanel/scripts/fix-web-vhost-configuration --user=username

Output

This scripts output could resemble the following example:

1
2
3
4
5
6
7
8

----- Checking username¦
--- Virtual host: example.com
Unrecognized: cpanel.example.com
Pending deletion: cpanel.example.com
Fixed!
- Non-SSL configuration¦

Done!