Migrate from DirectAdmin

Overview

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

DirectAdmin organizes data by user — each user owns a set of domains and databases. The migration tool preserves this structure and lets you select exactly what to migrate.

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 DirectAdmin 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 DirectAdmin server connection details:
   • SSH Host: The IP address or hostname of your DirectAdmin 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 DirectAdmin server

The system will automatically discover all users, websites, and databases available on your DirectAdmin server.

Step 3: Preview & Confirm

After scanning, you will see the results grouped by DirectAdmin user. Each user section shows their domains and databases.

Websites Section

• Domains are listed under each DirectAdmin user
• Each domain shows:
  • Domain name
  • Website file path
  • PHP version (automatically detected from DirectAdmin configuration)
  • Status badges:
    • Already Exists: The domain already exists on the target server (cannot be migrated)
    • No files: The website directory does not exist or is empty on the source server
    • Suspended: The domain is suspended on the DirectAdmin server
• Domains with no files or that already exist on the target server are automatically disabled
• Active domains with files are selected by default

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

• Databases are listed under each DirectAdmin user
• Each database shows:
  • Database name
  • Database user
  • Status indicator if the database already exists on the target server
• Databases that already exist will be replaced during migration (marked with "Will be replaced")
• All databases are selected by default

WARNING

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

Confirmation

• The total number of items to migrate is displayed at the bottom
• Review your selections carefully
• Click Confirm Migration to open the migration summary
• Review the summary and click Start Migration to begin the process

WARNING

If you select databases that already exist, they will be dropped and recreated during migration. Make sure you have backups if needed.

Step 4: Migration Progress

Once migration starts, the progress screen displays:

• Migration Summary: Shows the source (DirectAdmin) and target (FlashPanel) server names
• Progress Bars: Each website and database has its own progress bar showing:
  • Current status (Pending, In Progress, Completed, Failed)
  • Percentage complete
  • Current operation message
• Logs: Real-time log messages showing detailed migration steps

The migration process includes:

1. Linux User Creation: If the DirectAdmin user does not exist on the target server, it will be created automatically

2. Website Migration:

   • Copying website files from DirectAdmin to FlashPanel
   • Creating the website on FlashPanel
   • Automatically detecting and configuring PHP version from DirectAdmin configuration
   • Syncing web server configuration

3. Database Migration:

   • Exporting database from DirectAdmin
   • Creating database and user on FlashPanel
   • Importing database content
   • Linking database to website (if applicable)

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 DirectAdmin server allows SSH connections from your FlashPanel server's IP address. This is a common issue — make sure port 22 is open and the target server's IP is not blocked by a firewall.

• 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 DirectAdmin server. Your websites remain online during migration.

• User-based Structure: DirectAdmin organizes websites and databases by Linux user. The migration tool preserves this structure — each DirectAdmin user's domains are migrated under the same Linux user on the target server.

• PHP Version: The system automatically detects the PHP version configured for each domain in DirectAdmin and sets it up on FlashPanel. If the specific PHP version is not installed on the target server, the default PHP version will be used.

• Suspended Domains: Domains that are suspended on DirectAdmin can still be migrated. They are marked with a "Suspended" badge for your awareness.

• Admin User: The DirectAdmin admin user is excluded from the scan as it is a system user.