Child pages
  • Change Hostname

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
LIB:_Version
LIB:_Version

(WHM >> Home  >> Networking Setup >> Change Hostname)

Table of Contents
maxLevel3
minLevel2
stylenone

Overview

The Internet uses your hostname as a label by which to identify your physical server. This interface allows you to change your server's hostname.

Multiexcerpt
MultiExcerptNameHostnameWarning


Warning
titleImportant:
  • Do not select a hostname that begins with www or a number, or a hostname that ends with a hyphen (-).
  • You must use a fully-qualified domain name (FQDN) that uniquely identifies the server (for example, hostname.example.com or hostname.example.co.uk).
  • Do not choose a hostname that a cPanel account on your server will use.
  • Do not choose a potential proxy subdomain as a hostname (for example, cpanel.example.com or whm.example.com).
  • Do not select a socially-unacceptable hostname. The hostname will appear in mail headers.
  • Only use lowercase, Latin-script letters in hostnames.


The system displays your current hostname under the Current Hostname heading.

How to change your hostname

Include Page
LIB:_SetHostnameLink
LIB:_SetHostnameLink

To change your hostname, perform the following steps:

  1. Enter the new hostname into the New Hostname text box.

    Tip
    titleRemember:
    You must use a fully-qualified domain name as your new hostname. Your new hostname should also resolve to the server's main IP address.


  2. Click Change. A popup window will appear that confirms the hostname change is in progress.
  3. After the system changes your hostname, scroll to the bottom of the interface and click Add An A Entry for your hostname WHM's  Add an A Entry for Your Hostname interface (WHM >> Home >> DNS Functions >> Add an A Entry for Your Hostname).
  4. Review the information about your server and, if it is correct, click Add Entry.

The system will automatically configure the new hostname and add the correct A entry.

Note
titleNotes:
  • When you change your hostname, the system preserves the old hostname until you reboot the server so that currently-running services can function in a consistent environment.
  • If you must change your hostname for non-cPanel configuration files or services, these services continue to function until you manually adjust them.
  • If you use External Authentication, you must update the Redirection URI settings in the configuration settings at the external authentication provider's site to reflect the new hostname.

Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("networking","hostname") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("networking","hostname") and label = "cpanel" and space = currentSpace()


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("networking","hostname") and label = "whm" and space in (currentSpace(),"CKB")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("networking","hostname") and space = "DD"