• Friday, November 14, 2025

Migrating your web hosting environment from one control panel to another can be a significant undertaking, but with the right tools and guidance, it can be a smooth process. This guide provides a detailed overview of how to transition your hosting from cPanel to Plesk, leveraging the capabilities of the Plesk Migrator tool. We will explore two distinct methods, offering flexibility based on your preference and technical comfort level, ensuring a successful migration with minimal disruption.

Method 1: Migrating Using the Plesk Panel

This method offers a straightforward and user-friendly approach for migrating your cPanel environment to Plesk directly through the Plesk interface. It is ideal for users who prefer a graphical interface for managing their server operations. Follow these steps for a seamless transition:

  1. Log in to Plesk: Begin by accessing your Plesk control panel using your administrative credentials.
  2. Access Extensions: Navigate to the “Extensions” option, which is typically located on the left-hand side menu of the Plesk interface.
  3. Install Plesk Migrator: Within the “Extensions” section, locate “Plesk Migrator” under “Server Tools.” Click “Install” to initiate and complete the setup of this essential migration tool. Snag_7d207b10.png Snag_7d20d100.png
  4. Launch Plesk Migrator: Once the installation is complete, proceed to Extensions > My Extensions, and then click “Go to Extension” to open the Plesk Migrator interface.
  5. Start a New Migration: Initiate the migration process by clicking on “Start a New Migration.” This will guide you through the initial setup wizard.
  6. Configure Source Server Details: When prompted, select cPanel as your source platform. You will need to provide the actual IP address of your source cPanel server, specify the SSH port (the default is 22), and input the root user’s login credentials for the source server to establish a connection.
  7. Prepare and Complete Migration: Click “Prepare Migration” and carefully follow any subsequent on-screen instructions and prompts provided by the Plesk Migration Guide to finalize the process. This stage often involves reviewing detected services and confirming settings. Snag_7d215340.png

Method 2: Migrating Using the Command Line Interface (CLI through SSH)

For users who prefer command-line operations, demand more granular control, or are automating parts of their infrastructure management, the CLI method offers a powerful and robust alternative. This approach involves executing a series of commands via SSH to manage the migration process. To proceed with this method, follow these detailed steps:

  1. Log in to Plesk: Start by logging into your Plesk control panel.
  2. Install Plesk Migrator: Ensure the Plesk Migrator extension is installed. You can do this by following the initial steps (1-3) outlined in Method 1 above.
  3. Access Server via SSH: Connect to your Plesk server using an SSH client, such as PuTTY or the terminal on Linux/macOS.
  4. Create Configuration Directory: Generate the necessary “conf” directory if it does not already exist. This directory will house the configuration files for your migration. Run the following command to ensure the correct path exists: 
    mkdir /usr/local/psa/var/modules/panel-migrator/conf
  5. Navigate to Configuration Directory: Change your current working directory to the newly created “conf” directory: 
    cd /usr/local/psa/var/modules/panel-migrator/conf/
  6. Create and Populate config.ini: Create a file named “config.ini” within the current folder and populate it with the essential migration details. This file defines the source and target server parameters, including IP addresses and credentials: 
    # cat /usr/local/psa/var/modules/panel-migrator/conf/config.ini

[GLOBAL]
source-type: cpanel
source-servers: cpanel
target-type: plesk

[plesk]
ip: <destination_server_IP_address>
os: unix

[cpanel]
ip: <source_server_IP_address>
os: unix
ssh-password: <source_server_root_password>
# Uncomment ssh-port string below if the SSH port is not 22
# ssh-port: <custom_ssh_port_if_not_22>

    Important Note: If your cPanel server hosts any PostgreSQL databases, it is crucial to include the PostgreSQL administrator password within the “config.ini” file, as demonstrated below, to ensure their successful migration:

    [optional]
postgres-password: <password>
  7. Generate Migration List: Generate a comprehensive list of accounts slated for migration using the subsequent command. This list can be reviewed and subsequently edited to exclude specific domains or assign them to particular service plans within Plesk if needed: 
    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator generate-migration-list

    To modify this generated list, you can use a text editor like vi:

    vi /usr/local/psa/var/modules/panel-migrator/sessions/migration-session/migration-list
  8. Initiate Account Transfer: Begin the actual account transfer from the source cPanel server to the Plesk destination by executing the following command. This step initiates the core migration of user data and configurations: 
    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator transfer-accounts
  9. Resynchronize Data: Perform a data resynchronization to ensure all recent changes and updates are copied across. This command utilizes rsync to efficiently skip unchanged files, optimizing the transfer process: 
    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator copy-content
  10. Verify Migrated Data: Finally, after the migration is complete, it is essential to verify the integrity and correct functionality of all transferred data and services. Use this command to perform a comprehensive check: 
    /usr/local/psa/admin/sbin/modules/panel-migrator/plesk-migrator test-all

Successfully migrating from cPanel to Plesk provides a new, robust environment for managing your web hosting. By carefully following either the intuitive Plesk panel method or the precise command-line instructions detailed above, you can ensure a smooth and efficient transition. This minimizes downtime and helps ensure the continuous operation of your websites, applications, and email services within your new Plesk environment.

Back