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

For cPanel & WHM version 68

(WHM >> Home  >> Transfers >> Convert Addon Domain to Account)

Overview

This interface allows you to convert an existing addon domain into a full cPanel account. When you convert an addon domain into a stand-alone cPanel account, you gain more control over the domain’s resources, such as databases, FTP accounts, and SSH access. For more information, read our Addon Domains documentation.

Important:

  • You must have the rearrange-accts ACL to convert an addon domain into a cPanel account. For more information, read our ACL Lists documentation.
  • Due to the amount of data involved in the conversion, we recommend you have triple the space required for the addon domain available before you begin the process.
  • We strongly recommend you perform a backup of the original account that owns the addon domain before you begin the conversion.

Select addon domain

This interface lists all of the available addon domains and their owners. Enter a domain or owner in the Search text box to filter this list.

To convert an addon domain into an account, click the Convert icon () in the Action column for that domain.

Account Settings

The Account Settings section of the interface allows you to set the basic information for the account.

SettingDescription
UsernameThe username for the account that you will create. By default, we generate a username from the addon domain name.
Contact Email
(optional)
The main contact email address for the new account, to which the system will send notifications.
Package
(optional)
The package associated with the new account. You can select from the available packages listed in the menu.
Preserve Account Ownership

Select this checkbox to ensure that the reseller account that owned the addon domain will also own the new account.

Note:

This option is only available to root users.

Selection Details

This interface displays all of the items that the conversion can move and whether you chose to move them.

Copy the website configuration settings

This option allows you to copy the contents of the addon domain's document root and VirtualHost include files to the new account. This option defaults to Selected.

To copy the website configuration settings, perform the following steps:

  1. Click Configure on the Website Configuration  section heading.
  2. Select the Copy contents of document root directory checkbox.
  3. Select the Copy custom VirtualHost include files checkbox.
  4. Select the Copy the installed SSL certificate checkbox.

    Note:

    This checkbox is not available if the domain does not have an installed SSL certificate.

  5. Click Save Selections.

Copy custom DNS records

This option allows you to copy the addon domain's custom DNS records to the new account. This option defaults to  Selected .

Note:

If you deselect this option, your domain's DNS records will revert to the default values on the server. For more information about the default values, read our Edit Zone Templates documentation.

To copy the custom DNS records, perform the following steps:

  1. Click Configure in the Custom DNS Records section heading.
  2. Select the Move Custom DNS Records checkbox.
  3. Click Save Selections.

Copy email accounts, forwarders, and autoresponders

This option allows you to copy the addon domain's email accounts, forwarders, and autoresponders to the new account. If email accounts exist for this account, this option defaults to Selected.

To copy the email accounts and other features to the new account, perform the following steps:

  1. Click Configure in the Email section heading.
  2. To copy the email accounts, select the Copy email accounts checkbox.
  3. To move the email forwarders, select the Move email forwarders checkbox.
  4. To copy the autoresponders, select the Copy autoresponders checkbox.
  5. To copy the webmail data, select the Copy webmail data checkbox.
  6. Click Save Selections.

Notes:

  • Each checkbox applies to all items of that type. For example, you cannot choose to copy only some of the email accounts.
  • The conversion process moves the addon domain’s mailing lists and Roundcube webmail data even if you do not copy any email data.
  • The addon domain's new account will inherit the mailbox storage account of its original parent account. For example, if the parent account uses the maildir format, then the addon domain's new account will use maildir format, too.

Copy or move MySQL® databases

This option allows you to copy or move the addon domain's MySQL databases to the new account. This option defaults to Not Selected.

Note:

If you choose to Copy the MySQL databases, ensure that you have enough available disk space in the new location.

To copy the addon domain's MySQL databases to the new account, perform the following steps:

  1. Click Configure in the MySQL Database section heading.
  2. Select the Copy button in the How do you want to transfer your MySQL Databases? section.
  3. Select the checkbox next to each database that you want to copy, or select the checkbox in the table heading to select them all.
  4. Enter a new name for each selected database. If prefixing is enabled on the server, the new database name will automatically begin with the username_ prefix.

    Important:

    To learn more about database username limits, click your database type:

     MySQL

    MySQL limits the database username to 16 characters. The system includes the database prefix (the first eight characters of the cPanel account's username and an underscore character) in the character count for the username.

    For example:

    • A MySQL database with the db_ prefix allows usernames that contain up to 13 characters.
    • A MySQL database with the example_ prefix allows usernames that contain up to eight characters.
     MariaDB

    MariaDB limits the database username to 47 characters. The system includes the database prefix (all of the cPanel account's username and an underscore character) in the character count for the username.

    For example:

    • A MariaDB database with the db_ prefix allows usernames that contain up to 44 characters.
    • A MariaDB database with the example_ prefix allows usernames that contain up to 39 characters.
     
  5. Click Save Selection.

To move the addon domain's MySQL databases to the new account, perform the following steps:

  1. Click Configure in the MySQL Database section heading.
  2. Select the Move button in the How do you want to transfer your MySQL Databases? section.
  3. Select the checkbox next to each database that you want to move, or select the checkbox in the table heading to select them all.

    Note:

    When you move a database, the following permission changes will occur:

    • The addon domain owner will lose access to the database.
    • The newly created cPanel account will gain full access to the database.
  4. Select the checkbox next to each database user that you want to move, or select the checkbox in the table heading to select them all. 

    Note:

    If you move a database user and not a database to which they have access, the user will lose all access to that database.

  5. Click Save Selection.

Copy subaccounts

This option allows you to copy the addon domain's subaccounts to the new account. This option defaults to Selected.

To copy the subaccounts, perform the following steps:

  1. Click the Configure button in the Subaccounts section heading.
  2. Select the Copy FTP accounts checkbox.
  3. Select the Copy Web Disk accounts checkbox.
  4. Click Save Selections.

Start Conversion

After you configure the selection details for the addon domain you want to convert into a cPanel account:

  • Click Start Conversion to begin the process.
  • Click Cancel to return to the Select addon domain section of the interface.

For more details about how conversion affects the addon domain data, read our Addon Domain Conversion List documentation.

Conversion History

The Conversion History page displays completed and in-progress addon domain conversions.

  • Click View Conversion History to view to the Conversion History.

The Conversion History page lists the following information on converted addon domains:

ColumnDescription
DomainThe name of the addon domain you converted into an account.
StatusThe current status of the conversion: Done, In Progress, or Failed.
Start TimeThe time when the conversion process began.
End TimeThe time when the conversion process finished.
ActionsClick Details to view additional information about the conversion process.

Click View Addon Domains to return to the main Convert Addon Domain to Account section of the interface.

Additional documentation