wp-migrate

Migrate WordPress sites and databases between servers using wp-migrate.sh.

3|1|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/BWBama85/wp-migrate.sh --skill wp-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-migrate
Source: https://github.com/BWBama85/wp-migrate.sh/tree/main/.claude/skills/wp-migrate
Command: npx skills add https://github.com/BWBama85/wp-migrate.sh --skill wp-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress migrations are often error-prone and time-consuming, involving multiple manual steps like exporting databases, syncing wp-content, and updating URLs. This Skill encapsulates the end-to-end workflow of wp-migrate.sh to reduce downtime, minimize complexity, and standardize deployments across environments.

Core Features & Use Cases

  • Push mode: migrate wp-content and database from a source to a destination server via SSH with preflight checks, maintenance mode, and 1:1 wp-content synchronization.
  • Archive mode: import backups from Duplicator, Jetpack Backup, and Solid Backups with auto-detection, URL alignment, and safe rollback guidance.
  • Use cases include deployments, staging-to-production migrations, CI/CD automation, and disaster recovery planning.

Quick Start

Run a basic dry-run to preview operations: ./wp-migrate.sh --dest-host user@dest --dest-root /var/www/html --dry-run

Frequently Asked Questions about wp-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a WordPress site between servers?

WordPress migration transfers your site's files and database from one server to another. wp-migrate.sh automates this end-to-end using push mode (SSH sync with preflight checks) or archive mode (import from Duplicator, Jetpack Backup, or Solid Backups), handling URL rewrites, maintenance mode, and rollback safety automatically.

Can I use wp-migrate with backup archives from Duplicator or Jetpack Backup?

Yes. wp-migrate.sh supports archive mode with auto-detection for Duplicator, Jetpack Backup, and Solid Backups. It extracts, aligns URLs, synchronizes content and databases, and provides rollback guidance if needed.

What safety checks does WordPress migration include?

wp-migrate.sh performs disk space validation, creates automated backups before migration, enables maintenance mode during sync, supports dry-run previews to preview operations without applying changes, and provides rollback guidance for recovery.

How do I preview a WordPress migration before running it?

Use the --dry-run flag to simulate operations without modifying your destination server. Run ./wp-migrate.sh --dest-host user@dest --dest-root /var/www/html --dry-run to inspect changes, paths, and database updates before committing.

Can I automate WordPress deployments with CI/CD?

Yes. wp-migrate.sh integrates with CI/CD workflows, supports verbose and trace logging for debugging pipelines, validates input strictly, and works with StellarSites hosting for automated deployment and staging-to-production migrations.

What's the difference between push mode and archive mode migration?

Push mode migrates live wp-content and databases directly between servers via SSH with preflight checks and maintenance mode. Archive mode imports from backup files with auto-detection and URL alignment, suited for disaster recovery or restoring from exported backups.