# Import Process
All migrations in PanelAlpha follow a standardized process with multiple steps, regardless of the import method used (automatic or manual). Understanding these steps helps troubleshoot issues and monitor progress effectively.
# Import Steps Breakdown
Each import goes through these steps in order:
- Install new instance – Create hosting account, set limits, domain, docroot, PHP/web server config, DNS (if enabled).
- Install plugin on destination (plugin methods only) – Fresh WordPress, migrator plugin, credentials configured.
- Prepare destination workspace – Stage directory, temp FTP (manual), permissions, server readiness checks.
- Install plugin on source (plugin auto-login path) – Log into WP admin, upload/activate plugin, link to PanelAlpha. Skipped if client installed manually.
- Prepare migration – Analyze source, size check, manifest/checksums, compatibility, download files + DB.
- Plugin: transfer via plugin API with chunking
- FTP: download via FTP/SFTP from source server
- Manual: use uploaded ZIP and SQL files
- Run migration – Extract files, create DB, import SQL, update URLs (search-replace + serialized), update
wp-config.php, set keys/salts, clear caches, validate.- Plugin-only tasks: auto-cleanup after plugin handoff
- Manual: proceeds after verification; no stop button once started
- Clean up – Remove source plugin (auto-install), delete temp FTP and staging files, remove artifacts, finalize record and set instance active.
# Data sources by method
| Step | Plugin (Simple) | Plugin (Manual install) | FTP/SFTP | Manual |
|---|---|---|---|---|
| Files source | WP Admin via plugin API | WP Admin via plugin API | FTP/SFTP path | wordpress-files.zip uploaded |
| DB source | Plugin export | Plugin export | FTP/SFTP download | database.sql (or compressed) |
| Stop mid-run | ✅ | ✅ | ✅ | ❌ |
| Needs WP admin creds | Optional (auto-login) | No (client installs) | No | No |
# Post-Import Automatic Actions
After successful import completion, PanelAlpha automatically performs the following actions:
- Caches instance details: Stores instance information for faster dashboard loading
- Initiates PageSpeed analysis: Scheduled 2 minutes after import to allow site stabilization
- Creates DNS zone and records: If external DNS server is configured in PanelAlpha
- Sets up email domain: If external email server is configured (mailboxes, forwarding)
- Generates automatic SSL certificate: Orders and installs SSL if AutoSSL/Let's Encrypt is enabled
- Syncs report providers: Connects Google Analytics etc.
- Enables automatic backup: Activates backup schedule if configured for the plan
- Sends notifications: Notifies user and admins about successful import
# Import Status Indicators
Each step can have one of the following statuses:
- Not Started (gray circle): Step hasn't been executed yet, waiting for previous steps
- In Progress (yellow/orange spinner): Step is currently being executed
- Completed (green checkmark): Step finished successfully without errors
- Failed (red alert icon): Step encountered an error and couldn't complete
When a step fails, the entire import is marked as failed, and you'll see:
- The specific step that failed highlighted in red
- Detailed error message describing what went wrong
- Step-specific error details in the Logs tab
- Suggested actions to resolve the issue
- Retry option to re-run the migration
# Migration Process Flow
# Automatic Migration (Plugin Method with Login)
- Client initiates import and enters WordPress URL.
- Provides WP admin credentials.
- PanelAlpha validates credentials and lets client choose service/options.
- PanelAlpha logs into WordPress and installs migration plugin.
- Plugin analyzes source, downloads files and database.
- Uploads to destination, extracts/imports, configures WordPress.
- Cleanup completes and migration is marked done.
# Automatic Migration (Plugin Method - Manual Install)
- Client initiates import and enters WordPress URL.
- Downloads plugin ZIP and installs/activates it in WordPress.
- Plugin connects to PanelAlpha; client selects service/options.
- Plugin analyzes source, downloads files and database.
- Uploads to destination, extracts/imports, configures WordPress.
- Cleanup completes and migration is marked done.
# Automatic Migration (FTP Method)
- Client initiates import and enters WordPress URL.
- Provides FTP/SFTP credentials and path.
- PanelAlpha verifies connection and detects WordPress install.
- Client selects service and options.
- PanelAlpha downloads files and database via FTP/SFTP.
- Uploads to destination, extracts/imports, configures WordPress.
- Cleanup completes and migration is marked done.
# Manual Migration
- Admin initiates migration and selects user + service.
- PanelAlpha creates instance and generates temporary FTP credentials.
- Admin uploads
wordpress-files.zipanddatabase.sql(or compressed). - Admin clicks Verify; PanelAlpha validates uploads.
- Admin clicks Continue Import to extract/import.
- PanelAlpha configures WordPress.
- Cleanup completes and migration is marked successful.
# Related Documentation
- Migration Types - Understand different migration methods
- Managing Migrations - Monitor and manage migrations
- Migration Details - Detailed information about each migration
- Troubleshooting - Solve common migration issues