Migrate from aaPanel

Overview

The migration tool allows you to transfer websites and databases from your aaPanel server to your FlashPanel server automatically. This process copies all website files, database content, and configurations without manual intervention.

Prerequisites

Before starting the migration, ensure:

• You have at least one server added to FlashPanel
• Your target server has a web server (Nginx, Apache2, or OpenLiteSpeed) installed if you plan to migrate websites
• Your target server has a database server (MySQL or MariaDB) installed if you plan to migrate databases
• You have SSH access credentials for your aaPanel server

How to Migrate

Step 1: Select Target Server

1. Navigate to the migration page from the servers list
2. In the Select Target Server step, choose the FlashPanel server where you want to migrate your websites and databases
3. Click Next to proceed

INFO

The target server is where your websites and databases will be migrated to. Make sure it has sufficient resources and the required services installed.

Step 2: SSH Connection

1. Enter your aaPanel server connection details:
   • SSH Host: The IP address or hostname of your aaPanel server
   • SSH Port: Usually 22
   • SSH Username: Your server login username (typically root)
   • Authentication Method: Choose either:
     • SSH Password: Enter your server password
     • SSH Private Key: Paste your SSH private key
   • Use sudo: Enable this if your user requires sudo privileges
2. Click Scan to connect and scan your aaPanel server

The system will automatically discover all websites and databases available on your aaPanel server by querying the SQLite database.

Step 3: Preview & Confirm

After scanning, you will see:

Websites Section

• A list of all websites found on your aaPanel server
• Each website shows:
  • Domain name
  • Project type (PHP, Node, Go, Python, etc.)
  • PHP version (automatically detected from virtual host configuration for PHP websites)
  • Website path
  • Status indicator if the website already exists on the target server
• Use Select All or Deselect All to quickly manage your selection
• Websites that already exist on the target server are automatically disabled and marked with an "Already Exists" badge

WARNING

If your target server does not have a web server installed, you cannot select websites for migration. Install Nginx, Apache2, or OpenLiteSpeed first.

Databases Section

• A list of all databases found on your aaPanel server
• Each database shows:
  • Database name
  • Database user
  • Database password (from aaPanel)
  • Status indicator if the database already exists on the target server
• Use Select All or Deselect All to quickly manage your selection
• Databases that already exist will be replaced during migration (marked with "Will be replaced")

INFO

In aaPanel, databases and websites are independent entities with no direct link between them. You can migrate databases without migrating their associated websites.

WARNING

If your target server does not have a database server installed, you cannot select databases for migration. Install MySQL or MariaDB first.

Step 4: Monitor Progress

Once you confirm the migration, you can monitor the progress in real-time:

• Progress Bars: Visual indicators showing the completion percentage for each migration step
• Logs: Real-time log messages showing detailed migration steps

You can monitor the progress in real-time. The migration process includes:

1. Website Migration:

   • Copying website files from aaPanel to FlashPanel
   • Creating the website on FlashPanel
   • Automatically detecting and configuring PHP version from virtual host configuration (for PHP websites)
   • Setting up proxy port for Node.js/Go/Python projects (if applicable)
   • Syncing web server configuration
   • Handling .user.ini files from aaPanel to avoid conflicts

2. Database Migration:

   • Exporting database from aaPanel
   • Creating database and user on FlashPanel
   • Importing database content
   • Using password from aaPanel if available

Notes & Warnings

• Website Conflicts: If a website with the same domain already exists on the target server, it cannot be migrated. You must remove the existing website first or choose a different target server.

• Database Replacement: Existing databases with the same name will be dropped and recreated. All data in the existing database will be lost.

• Service Requirements:

  • Websites require a web server (Nginx, Apache2, or OpenLiteSpeed) on the target server
  • Databases require a database server (MySQL or MariaDB) on the target server

• SSH Access: Ensure your aaPanel server allows SSH connections from your FlashPanel server's IP address.

• Migration Time: The time required depends on the size of your websites and databases. Large migrations may take several minutes.

• No Downtime: The migration process does not affect your aaPanel server. Your websites remain online during migration.

• Project Types: The migration tool supports:

  • PHP: Standard PHP websites with automatic PHP version detection from virtual host configuration
  • Node.js: Node.js applications with proxy port configuration
  • Go/Python: Other project types with proxy port support

• PHP Version: For PHP websites, the system automatically detects the PHP version from the virtual host configuration file (Nginx/Apache2/OpenLiteSpeed) and configures it accordingly on FlashPanel.

• Proxy Port: For Node.js, Go, and Python projects, the proxy port from aaPanel will be automatically configured on FlashPanel.

• Independent Databases: In aaPanel, databases and websites are independent entities. You can migrate databases without migrating their associated websites, and vice versa.