1. cPanel & WHM Documentation
  2. WHM
  3. Transfers
  4. Convert Addon Domain to Account
domains accounts whmui

Convert Addon Domain to Account

Valid for versions 82 through the latest version

Version:

82

Last modified: December 7, 2022

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 Domains documentation.

Important:
  • You must have the rearrange-accts ACL to convert an addon domain into a cPanel account. For more information, read our Edit Reseller Nameservers and Privileges documentation.
  • The addon domain’s data remains on the source account after this process completes. Due to this, converting an addon domain to a full cPanel account requires a large amount of disk space.
    • We recommend that your server has triple the space that the new domain needs before you begin this process.
    • After the process completes, you must remove the data from the source account. This reduces your account’s data usage.
  • We strongly recommend you perform a backup of the original account that owns the addon domain before you begin the conversion.
  • You must delete the subdomains of the addon domain before you convert it to a cPanel account. If you do not perform this action, the conversion process will fail.
Note:

This interface does not display addon domains for cPanel accounts set as a linked mail node.

Select addon domain

This section of the 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 Convert in the Action column for that domain. A new interface will appear with the following sections:

Account Settings

This section of the interface allows you to set the basic information for the account.

  • Username — The username for the account that you will create. By default, the system generates a username using 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 for the new account.
  • 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 setting is only available to users with root-level privileges.

Selection Details

This section of the interface displays settings for the items that the conversion can move.

Website Configuration

These settings allow you to copy the contents of the addon domain’s document root and VirtualHost include files to the new account.

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

  1. Click Configure on the Website Configuration section heading.
  2. Select the checkboxes for the items you want to copy:
    • Copy contents of document root directory — Copy the contents of the addon domain’s document root.
    • Copy custom VirtualHost include files — Copy the contents of custom VirtualHost include files.
    • Copy the installed SSL certificate — Copy the addon domain’s SSL certificate.
      Note:
      • The Copy the installed SSL certificate checkbox is not available if the domain does not have an installed SSL certificate.
      • The system selects these checkboxes by default.
  3. Click Save Selections.

Custom DNS Records

This setting allows you to copy the addon domain’s custom DNS records to the new account.

To copy custom DNS records, perform the following steps:

  1. Click Configure in the Custom DNS Records section.
  2. Select the Move custom DNS records checkbox.
    Note:
    • The system selects this checkbox by default.
    • If you deselect this checkbox, 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.
  3. Click Save Selections.

Email

These settings allow you to copy the addon domain’s email accounts, forwarders, and autoresponders to the new account.

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. Select the checkboxes for the items you want to copy:
    • Copy email accounts — Copy the addon domain’s email accounts.
    • Move email forwarders — Move email forwarders with the addon domain.
    • Copy autoresponders — Copy the addon domain’s autoresponders.
    • Copy webmail data — Copy the addon domain’s email accounts’ Webmail data.
      Note:

      The system selects these checkboxes by default.

  3. Click Save Selections.
Note:
  • 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 the original account. For example, if the parent account uses the maildir format, then the addon domain’s new account will use the maildir format.

MySQL Databases

This setting allows you to copy or move the addon domain’s MySQL® or MariaDB databases to the new account.

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.
  2. Click Copy 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.
    Note:

    The system deselects these checkboxes by default.

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

  2. Click Move 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 the database to which they have access, the user will lose all access to that database.

  5. Click Save Selection.

Subaccounts

This setting allows you to copy the addon domain’s subaccounts to the new account. The system selects these checkboxes by default.

To copy the subaccounts, perform the following steps:

  1. Click Configure in the Subaccounts section.
  2. Select the checkboxes for the items you want to copy:
    • Copy FTP accounts — Copy the FTP accounts for copied subaccounts.
    • Copy Web Disk accounts — Copy the Web Disk accounts for copied subaccounts.
      Note:

      The system selects these checkboxes by default.

  3. Click Save Selections.

Start Conversion

After you configure these settings:

  • Click Start Conversion to begin the process and view to the Conversion History table.
  • 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 table displays completed and in-progress addon domain conversions. Click View Conversion History in the top-right corner of the main Convert Addon Domain to Account interface to view to the Conversion History table.

The Conversion History table lists the following information about converted addon domains:

  • Domain — The name of the addon domain you converted into an account.
  • Status — The current status of the conversion (Done, In Progress, or Failed).
  • Start Time — The time when the conversion process began.
  • End Time — The time when the conversion process finished, if it is complete.
  • Actions — Click Details to view additional information about the conversion process.

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

Additional Documentation