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 domains resources, such as databases, FTP accounts, and SSH access. For more information, read our Domains documentation.

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 domains 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 domains document root.
   • Copy custom VirtualHost include files  Copy the contents of custom VirtualHost include files.
   • Copy the installed SSL certificate  Copy the addon domains 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 domains 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 domains 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 domains 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 domains email accounts.
   • Move email forwarders  Move email forwarders with the addon domain.
   • Copy autoresponders  Copy the addon domains autoresponders.
   • Copy webmail data  Copy the addon domains email accounts Webmail data.
     Note:

     The system selects these checkboxes by default.

3. Click Save Selections.

MySQL Databases

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

To copy the addon domains 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 accounts 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 accounts 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 domains 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 domains 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.