Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46


The  /etc/wwwacct.conf file contains the most basic setup instructions for cPanel & WHM. This includes the hostname, nameservers, and some other important information that cPanel servers require. After you install cPanel & WHM, you can find and edit most of this information in the Basic cPanel & WHM Setup  interface ( Home >> Server Configuration >> Basic cPanel & WHM Setup ).

Preconfigure the /etc/wwwacct.conf file

To set the configuration of the /etc/wwwacct.conf file before you install cPanel & WHM, perform the following steps:

  1. With your preferred editor, create the /etc/wwwacct.conf file as the root user.

  2. With one entry per line, list all of the parameters that appear in the table below.


    You must include all of the parameters that are listed in the table below in your /etc/wwwacct.conf file, even if you do not wish to specify a value for a parameter.

  3. Specify the values that you wish to configure. Separate each key and its value with a space. For example:



The following table contains all of the parameters that you must include in your /etc/wwwacct.conf file.

ADDRYour server's default IP address.
CONTACTEMAILThe system administrator's email address. This address will receive notifications of account creation or termination, service status information, and several other events.
CONTACTPAGERThe number to which you wish the server to send SMS notifications.
DEFMODThe default cPanel theme that you wish to use.
ETHDEVThe default ethernet device. This should normally be eth0 on Linux servers, unless the server runs Virtuozzo.
HOMEDIRThe path to the default home directory.
HOMEMATCHA string that the user will use to determine which partitions to use as home directories for new accounts. (For example, a value of users might match system mounts of usersusers1users3.)

The Apache log format that you wish to use.


Always set  combined as the value for this parameter.

MINUIDThe minimum UID for cPanel created accounts. The default value is 500.
NS, NS2, NS3, and NS4Nameservers to add to DNS zones by default. You must configure at least the NS and NS(2) values, or account creation will fail.
NSTTLThe default TTL value that DNS zones will use.
SCRIPTALIASDefines whether a /cgi-bin/ directory should be aliased on account creation. The value must be either y or n.