Child pages
  • Basic WebHost Manager Setup
For cPanel & WHM version 76

Skip to end of metadata
Go to start of metadata

(WHM >> Home >> Server Configuration >> Basic WebHost Manager® Setup)

Overview

This interface allows you to configure basic options for cPanel & WHM, such as contact information or nameservers. The system displays all available setup options by default.


This section allows you to configure the following options:

OptionDescriptionExample
Enter one or more email addresses to contact in case a problem arises with this server.

An email address to serve as your contact address if problems occur. The system also uses this address to create the RNAME field in the Start of Authority (SOA) record in the DNS record zone.

Notes:

  • Use a comma-separated list of email addresses to designate multiple contacts.
  • If you do not enter an email address, cPanel & WHM sends the following notifications to the root user:
    • Installer notifications.
    • Update (upcp) notifications.
    • New and terminated account notifications.
    • Errors from the check_cpanel_rpms script.
    • Failed service notifications (for example, IMAP or the httpd daemon).

Important:

We recommend that you enter an email account that does not exist on the server.

user@example.com
Enter one or more cellular phone or pager email addresses to message via email in case a problem arises with this server.

A comma-separated list of cell phone or pager email addresses that can receive notifications if problems occur.

user@sms.com, 8005551212@provider.com
An API Token for the Pushbullet APIA comma-separated list of Access Tokens for the Pushbullet™ accounts that you wish to receive notifications if problems occur.

a1b2c3d4e5f6g7h8i9j0, z0y9x8w7v6u5t4s3r2q1

The ICQ ID that this server should use for login to ICQ when sending alerts.

An ICQ number that your server can use to send notifications if problems occur.

Notes:

  • To disable or fine-tune ICQ notifications, use the Contact Manager interface (WHM >> Home >> Server Contacts >> Contact Manager).
  • To register for an ICQ number, visit ICQ's website.
1234567
The ICQ ID password for sending alerts.The password for your server's ICQ number.luggage123456
Enter one or more ICQ user identification numbers (comma delimited) you can be reached at in case a problem arises with this server.A comma-separated list of the ICQ numbers at which you wish to receive notifications if problems occur.1234568, 11223344, 1020304
HipChat Room(s) and User(s) to notifyA comma-separated list of HipChat™ rooms and users. Prepend any usernames with the at symbol (@) or enter their full email address.Example_Room, @username, username@example.com
Attach a copy of the .eml notification when sending via HipChat

Select whether to attach a copy of the notification in .eml format. to the message

This option defaults to Off.

Off
Your HipChat API endpoint’s URL.

Enter the HipChat API endpoint through which to send the message.

This option defaults to https://api.hipchat.com/v2/.

https://api.hipchat.com/v2/
Send the full text of the notification in chat.

Whether to enable full text of the notification in the chat message. If you disable this option, the system only sends a summarized message.

This option defaults to On.

On
The HipChat Token for your HipChat username.

The HipChat Token for your HipChat username. For more information, read Atlassian's API access tokens documentation.

01234567890
A comma-separated list of http:// or https:// URLs of a system to which you want to send POST notifications as form data with the keys "hostname", "subject", and "body".

The URL for a form handler or ticket system that you wish to send the alert information. The system automatically sends the parameter's hostname, subject, and body with the relevant data from the alert.

Notes:

  • To send additional parameters, include those keys after the URL. For example, to send the apikey parameter with a value of XXXXX, append ?apikey=XXXXX to the URL.
  • To add additional parameters and values, separate those additional values with the ampersand character (&) instead of the question mark character (?). For example, to include a state parameter of Texas and a status parameter of CRITICAL, append ?apikey=XXXXX&state=Texas&status=CRITICAL to the URL.
  • If you enter a secure URL (https://), that site must possess a valid certificate.
https://www.cpanel.net/events.cgi?apikey=XXXXX&state=Texas&status=CRITICAL

This section allows you to configure the following options:

OptionDescriptionExample
The IPv4 address (only one address) to use to set up shared IPv4 virtual hosts.

Required

A single IPv4 address to function as the server's shared IPv4 address. All of the accounts on your server that do not require a dedicated IPv4 address may use this IP address.

Note:

If you change this IP address, the change will not affect accounts that use the previous value. To change the IP address for these accounts, use WHM's IP Migration Wizard interface (WHM >> Home >> IP Functions >> IP Migration Wizard).

10.11.133.14
The IPv6 address (only one address) to use to set up shared IPv6 virtual hosts.

A single IPv6 address to function as the server's shared IPv6 address. All of the accounts on your server that do not require a dedicated IPv6 address may use this IP address.

Important:

An IPv6 address range cannot contain a server's shared IP address. The system does not allow you to set a shared IP address that exists within any configured IPv6 address range.

Notes:

  • If you change this IPv6 address, the change will not affect accounts that use the previous value. To change the IPv6 address for these accounts, use WHM's Assign IPv6 Address interface (WHM >> Home >> IP Functions >> Assign IPv6 Address).
  • For all of cPanel & WHM's features to function properly on IPv6, the cpsrvd daemon must listen on IPv6 addresses. To enable this functionality, select On for the Listen on IPv6 Addresses setting in the System section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).
  • We strongly recommend that you disable the Prefer IPv4 over IPv6 for outgoing mail setting in the Basic Editor section of WHM's Exim Configuration Manager interface (WHM >> Home >> Service Configuration >> Exim Configuration Manager) if you use IPv6 on your server. If you do not disable this setting, you may experience problems with outgoing mail on IPv6.

  • You cannot add this IPv6 address to any IPv6 range that you add through WHM's IPv6 Ranges interface (WHM >> Home >> IP Functions >> IPv6 Ranges).

  • When you configure this setting, BIND automatically starts to listen for DNS requests via IPv6.

0:0:0:0:0:ffff:c000:200
The ethernet device onto which new IP addresses are added.

Required

Select which detected Ethernet device to add new IP addresses for your server, or enter a new device in the Other text box.

eth0
Enter the location where you wish for new users' home directories to be created.

A location in your server's file system to contain all of your cPanel users' home directories or enter one in the text box.

Note:

We recommend that you use home in the name of the directory. By default, cPanel & WHM checks all directories that match the home directory prefix for available disk space.

This option defaults to /home.

/home
Additional home directories matching the following value will also be used for new home directory creations.

An additional directory that you wish to use to store your cPanel users' home directories or enter one in the text box. This option only accepts one value.

Note:

If you use more than one directory to store cPanel accounts, the directory with the most free space automatically stores new accounts.

This option defaults to home.

home
Select a default theme for the cPanel interface.

The default theme for the cPanel interface. The menu displays all of the interface themes that your server offers.

Notes:

  • The theme that you select becomes the default theme whenever you create an account, create a package, restore an account, or transfer an account.
  • The system uses the default theme whenever an account's configuration does not specify a theme or uses a theme that does not exist on the server.
  • If you do not select a default cPanel theme, cPanel & WHM uses the system default theme.

This option defaults to paper_lantern.

paper_lantern
Select the Webmail default theme.

The default theme for the Webmail interface from this menu. This menu displays all of the Webmail themes that your server offers.

Notes:

  • The system uses the default theme whenever an account's configuration does not specify a theme or uses a theme that does not exist on the server.
  • If you do not select a default Webmail theme, cPanel & WHM uses the system default theme.

This option defaults to paper_lantern.

paper_lantern
Automatically create a cgi-bin script alias.

Whether the Apache web server software automatically aliases scripts in the httpd.conf file. For more information, read the Apache web server documentation about the ScriptAlias directive.

Note:

This setting can be individually overridden during account creation.

This option defaults to Yes.

Yes
This value defines the caching time for host name lookups for domains hosted on this server.

Required

A Time To Live (TTL) value, in seconds, for DNS records.

Notes:

  • Shorter TTL values can cause heavier loads on the nameserver, but return more accurate information for zones that contain records that change frequently. 
  • Specify a value in seconds (RFC 2181) between 0 and 2147483647.

This option defaults to 14400.

14400
This value is similar to the previous setting, but is specifically the value used for newly created zone file’s authoritative nameserver entries.

Required

A TTL value, in seconds, for a newly-created zone file's authoritative nameserver entries.

This option defaults to 86400.

86400
Enter the style in which you wish to receive your Apache logs.

The style in which you wish to view Apache log files. You may select either of the following options:

  • combined — This option displays Apache log files with all of a request's information. This includes referers, user agents, and requested files.
  • common — This option only displays Apache log files with information about requested files.

This option defaults to combined.

combined

This section allows you to specify your server's nameservers. Enter the nameservers that you wish to use as your primary, secondary, tertiary, and quaternary nameservers in the appropriate text boxes.

Notes:

  • A entries allow your nameserver to resolve to an IP address.
  • Your nameservers require A entries to work over IPv4 properly.
  • Your nameservers require AAAA entries to work over IPv6 properly.

To add an A entry or an AAAA entry for a nameserver, perform the following steps:

  1. Click Configure Address Records. A new window will appear.
  2. The system will perform a DNS lookup on the nameserver that you entered and list the results in the IP Addresses table.
    • To enter a different IPv4 address, change the entry in the Enter an IPv4 address to create an A record text box.
    • To enter a different IPv6 address, change the entry in the Enter an IPv6 address to create an AAAA record (optional) text box.
  3. The system will display the results of your changes. Click Close.

Save your changes

To save your changes to the server's settings, click Save Changes.

Additional documentation