Page tree

Versions Compared

Key

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

Include Page
_Version
_Version

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

Table of Contents
maxLevel3
stylenone

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.

Warning
titleImportant:
  • 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 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
titleNote:

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
    titleNote:

    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
titleNote:

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.
Note
titleNotes:
  • 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
titleNote:

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.
    Include Page
    _MySQL Username Limit
    _MySQL Username Limit
     
  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
    titleNote:

    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
    titleNote:

    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

Localtab Group
Localtab
activetrue
titleSuggested documentation

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

Localtab
titleFor cPanel users

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

Localtab
titleFor WHM users

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

Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("domains","accounts") and space = "SDK"