hostname

cPanel Installation Error – Invalid Hostname

I attempt to install cPanel/WHM on CentOS 7 but was greet with an invalid hostname error. I never encounter this error before although I do many times cPanel/WHM installation.

Below is the error message.

Your hostname is invalid. Update the hostname to a fully qualified domain name and rerun the installer.

My first attempt to solve this is by changing hostname in network configuration file. Seem strange but the hostname configuration already correct.

Second attempt is by issuing the following command

hostname host.domain.net

I try to reinstall cPanel/WHM & it works!. Make sure you change host.domain.net to your preferred FQDN.


How to Change Hostname on CentOS or Cloudlinux?

In order to change the your CentOS or Cloudlinux hostname permanently, you need to edit two files. The files are

  • /etc/sysconfig/network
  • /etc/hosts

Prior to changing the hostname, it is wise to check the existing hostname.

1. To do this issue the following command after SSH to you server

hostname

For example, my hostname is “host.domain.net”

2. Once completed, edit “/etc/sysconfig/network” file by issuing the following command

nano /etc/sysconfig/network

The example output as below,

NETWORKING="yes"
NETWORKING_IPV6="no"
GATEWAYDEV="eth0"
HOSTNAME=host.domain.net
DOMAINNAME=domain.net

3. Look for “HOSTNAME=host.domain.net”, and change to your desire hostname and save the file. Take note on the “hostname” format. It must be fully qualified domain name (FQDN).

4. Next, edit “/etc/hosts” file by issuing the following command

nano /etc/host

The example output as below,

127.0.0.1 localhost
88.88.88.88 host.domain.net

5. Again, look for “host.domain.net”, and change to your desire hostname as above and save the file.

6. Finally, and then rebooting the system

reboot