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

For cPanel & WHM version 56

(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, SSH access, etc. 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 link () 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 notifications will be sent.
Package
(optional)
The package associated with the new account. You can select from the available packages listed in the menu. For more information, read our Package documentation.
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 they are Selected or Not Selected.

Copy the contents of the document root

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

To copy the contents of the document root, perform the following steps:

  1. Click the Configure button on the Document Root section heading.
  2. Select the Copy contents of document root directory checkbox.
  3. 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 the Configure button 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 the Configure button in the Email section heading.
  2. If you want to copy the email accounts, select the Email Accounts checkbox.
  3. If you want to copy the email forwarders, select the Email Forwarders checkbox.
  4. If you want to copy the autoresponders, select the Autoresponders checkbox.
  5. 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 even if you do not copy any email data.

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 the Configure button 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 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 to expand the following:

     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 up to 13 characters long.
    • A MySQL database with the example_ prefix allows usernames up to eight characters long.
     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 up to 44 characters long.
    • A MariaDB database with the example_ prefix allows usernames up to 39 characters long.
     
  5. Click Save Selection.

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

  1. Click the Configure button 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 you want to move, or select the checkbox in the table heading to select them all.

    Note:

    When you move a database:

    • 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 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.

Start Conversion

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

  • Click the Start Conversion button to begin the process.
  • Click Cancel to return to the Select addon domain screen.

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