Child pages
  • Modify an Account

Versions Compared

Key

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

(WHM >> Home >> Account Functions >> Modify an Account)

Table of Contents
stylenone

Overview

The Modify an Account interface allows you to make changes to an existing account.

Modify an account

To modify an account, perform the following steps:

  1. Select the desired account and click Modify.
  2. Make changes to the settings in the sections below.
  3. Click Save.

    Note
    titleNote:

    If you make changes to the Resource LimitsPrivilegesDNS Settings, or Package Extensions sections, the Package Conflict Resolution dialog box appears.


Basic Information

This section allows you to edit the following options:

OptionDescription
Primary DomainEnter a new primary domain.
Username

Enter a username. The new username must meet the following requirements:

Include Page
LIB:_Account Username Restrictions
LIB:_Account Username Restrictions

Warning
titleWarning:
  • If you must change the account username, we recommend that the new name be the same length or shorter. A longer name may cause MySQL® to truncate the account's database names and database usernames, which causes problems.
  • If you change the username of an account, the following problems may occur:

    • You cannot use the associated websites and databases while the data transfers to the new username.
    • The system renames the user's home directory.
  • Make certain to verify the account’s integrity after the transfer finishes.


Note
titleNotes:

You cannot change resellers' usernames.


Rename prefixed databases and database users

The system selects the Rename prefixed databases and database users checkbox by default. If database prefixing is active on the server, this function changes the names of associated database objects (databases and database users) to use the first eight characters of the new username as a database prefix. For example, if you change the example username to example1, the system will rename the example_db database to example1_db and the fred_db1 user to example1_db1, but name of the steve database will not change.

Deselect this checkbox to rename only the cPanel account itself.

Warning
titleImportant:
  • When you rename an account, you can rename the account’s databases and database users to preserve the visual correspondence between database names and the username. However, this causes errors in applications that depend on the previous names.
  • If you do not rename the prefixed databases and database users, PostgreSQL® users cannot log in until they reset their passwords

Include Page
LIB:_RenameDatabase
LIB:_RenameDatabase

Account OwnerSelect a new account owner from the list of resellers.
Contact EmailEnter a new contact email for the account's owner.
Default LocaleSelect a new default locale.
cPanel Theme

Select a theme from the menu.

Note
titleNote:

To modify the theme and associated style for multiple accounts, use the /scripts/modify_accounts script. 




Enable Apache SpamAssassin™

Enable or disable Apache SpamAssassin's Spam Filters for the account. 

Note
titleNote:

You cannot modify this setting if you enable the Apache SpamAssassin™: Forced Global ON setting in WHM's Exim Configuration Manager interface (WHM >> Home >> Service Configuration >> Exim Configuration Manager).


Manual Resource Options

This section allows you to edit the following options:

OptionDescription
PackageSelect a hosting plan, which defines the limitations of the account. Click Change to navigate to the Upgrade Downgrade an Account interface (WHM >> Home >> Account Functions >> Upgrade/Downgrade an Account).
Disk Quota (MB)Enter the amount of space on the server’s hard drive for the new account, in Megabytes (MB).
Monthly Bandwidth Limit (MB)Enter the maximum amount of data that the new account can transfer each month, in Megabytes (MB).
Email AccountsEnter the maximum number of the account's email accounts.
Max Quota per Email Address (MB)

Enter maximum size that the account can define when it creates an email account, in Megabytes (MB).

Note
titleNote:

When you adjust this value it does not affect existing email accounts.


FTP AccountsEnter the maximum number of the account's FTP accounts.
Mailing Lists

Enter the maximum number of the account's mailing lists.

Note
titleNote:

The Mailman application handles mailing lists. For more information, read Mailman's overview documentation.


SQL Databases

Enter the maximum number of each available type of SQL database.

For example, if you set this value to 5 and allow MySQL® and PostgreSQL databases, the account can create up to five MySQL databases and up to five PostgreSQL databases.

SubdomainsEnter the maximum number of the account's subdomains.
Parked DomainsEnter the maximum number of the account's parked domains (aliases).
Addon DomainsEnter the maximum number of the account's addon domains.
Passenger Applications

Enter the maximum number of the account's Ruby applications.

Maximum Hourly Email by Domain Relayed

Enter the maximum number of emails that a domain can send per hour.

  • This value defaults to Unlimited.
  • A value of Set this value to 0 to allow unlimited outbound emails.
Note
titleNote:

This option sets the same limit for every domain on the account.

  • To set different limits for each domain, read our How to Set Email Send Limits documentation.
  • If you set different limits for each domain, default displays the limit that you set for the account's primary domain.


Maximum percentage of failed or deferred messages a domain may send per hour

Defines the maximum percentage of failed or deferred messages that a domain sends before your server temporarily blocks outgoing mail from that domain.

  • This value defaults to Unlimited.
  • The system examines outgoing and local mail over the previous hour to determine whether the domain exceeds the limit. 
  • When a domain exceeds the limit, it cannot send mail until the domain no longer exceeds the limit.

Privileges

This section allows you to edit the following options:

OptionDescription
Reseller PrivilegesSelect this checkbox to grant reseller privileges to the account.
CGI PrivilegeSelect this checkbox to grant the ability to serve CGI files to the account.
Shell AccessSelect this checkbox to enable SSH access for the account.

DNS Settings

This section allows you to edit the following options:

OptionDescription
Enable DKIM on this account

Select this checkbox to create DKIM records for all of the account's zones.

Note
titleNote:

If you disable DKIM, the system will delete any existing DKIM records on the account. 


Enable SPF on this account

Select this checkbox to create SPF records for all of the account's zones.

Note
titleNotes:
  • If you disable SPF, the system will delete any existing SPF records on the account. 
  • cPanel & WHM uses v=spf +a +mx+ipv4:local_address ?all as the default SPF record.
    • Add a custom SPF record to the appropriate DNS zone template to override this setting.
    • If the account's owner has also enabled SPF, the system automatically rewrites this record when you use WHM's Assign IPv6 Address interface (WHM >> Home >> IP Functions >> Assign IPv6 Address) to assign an IPv6 address.


Include Page
LIB:_GlobalSPFDKIM
LIB:_GlobalSPFDKIM

Package Extensions

If you included any package extensions with the account or its package, a Package Extensions section displays at the bottom of the interface. Some extensions may include variables that you can edit. Any options or settings that you can edit appear below the extension name.

Note
titleNotes:
  • Only package extensions that you included in the chosen package appear in this section. To learn more about extension options and how to change them, consult the extension's documentation.
  • You cannot use the WHM interface to add or remove installed extensions from an existing package. 
    • To use a different set of extensions, use the Add a Package interface (WHM >> Home >> Packages >> Add a Package) or use API calls to modify package extension data.
    • To change the account's package, use the Upgrade/Downgrade an Account interface (WHM >> Home >> Account Functions >> Upgrade/Downgrade an Account).

Remove missing extensions from package

If any of the account's extensions are not currently installed on the server, a warning message appears.

Warning
titleWarning:

You must install the missing extensions before you can edit their values.

If you do not wish to install the missing extensions, perform the following steps to remove them from the account's chosen package:

  1. Select the Remove missing extensions from package checkbox.
  2. Click Save Changes to remove the extensions from the package.
  3. The Package Conflict Resolution dialog box appears. Select the desired option and click Proceed.

Anchor
PkgConfRes
PkgConfRes
Package Conflict Resolution

The Package Conflict Resolution dialog box appears if you attempt to save settings that do not match the account's assigned package. 

If the Package Conflict Resolution dialog box appears, select the desired option and then click Proceed. You can choose one of the following options:

OptionDescription
Upgrade/downgrade the account to a package that matches the new propertiesChanges the account's package to a package that matches your chosen settings. This option only appears if one or more packages that match exist. Select the desired package from the menu.
Create a new package with this name

Creates a new package with your chosen settings.

  • The system upgrades or downgrades the account to this package.
  • The default name for the new package follows the oldpackagename_accountname format, where oldpackagename represents the name of the account's previous package, and accountname represents the account's name. You can also enter a new package name.
Update package (package name) with these new values

Updates the current package to the chosen settings.

Warning
titleWarning:

If you choose this option, the system applies the new settings to all of the accounts that use this package.


Set this account to have no package

Dissassociates the account from a package.

Note
titleNote:

If you choose this option, the system continues to associate the account with the current package extensions, because the system stores package extension data in the account's userdata file.


Keep this account on package (package name) (not recommended)

Continues to associate the account with its current package, but the settings in the account's userdata file do not match the settings in the package file.

Warning
titleWarning:

We do not recommend that you use this option, because the system could easily overwrite the chosen account settings with the package settings.


Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation


Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "accounts" and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "accounts" and label = "cpanel" and space = currentSpace()


Localtab
titleFor WHM users

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


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel = "accounts" and space = "DD"