PHPackages jsongerber/wp-sync-db - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. jsongerber/wp-sync-db ActiveWordpress-plugin[Database & ORM](/categories/database) jsongerber/wp-sync-db ===================== WP Sync DB eliminates the manual work of migrating a WP database. v2.0.5(8mo ago)181.8k—8.3%2GPL-2.0PHP Since May 18Pushed 8mo agoCompare [ Source](https://github.com/jsongerber/wp-sync-db)[ Packagist](https://packagist.org/packages/jsongerber/wp-sync-db)[ Docs](https://github.com/jsongerber/wp-sync-db)[ RSS](/packages/jsongerber-wp-sync-db/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (16)Used By (0) WP Sync DB ========== [](#wp-sync-db) - [Introduction](#introduction) - [Description and features](#description) - [Installation](#installation) - [Usage](#usage) - [Localization](#localization) - [Similar Tools](#similar-tools) - [Isn't this the same as WP Migrate DB Pro?](#isnt-this-the-same-as-wp-migrate-db-pro) - [Is this Illegal?](#is-this-illegal) Note This fork is maintained and will be updated with bug fixes and security patches. But no new features are planned, please open a PR if you have a feature request. Introduction ------------ [](#introduction) WP Sync DB eliminates the manual work of migrating a WP database. Copy your db from one WP install to another with a single-click in your dashboard. Especially handy for syncing a local development database with a live site. [![](https://camo.githubusercontent.com/61b3ead3c0653c9093009c1f3afa5ba4d45ef601c5ab0171d2afc8b47b96bf34/68747470733a2f2f7261772e6769746875622e636f6d2f736c616e673830302f707379636869632d6e696e6a612f6d61737465722f77702d6d6967726174652d64622e706e67)](https://camo.githubusercontent.com/61b3ead3c0653c9093009c1f3afa5ba4d45ef601c5ab0171d2afc8b47b96bf34/68747470733a2f2f7261772e6769746875622e636f6d2f736c616e673830302f707379636869632d6e696e6a612f6d61737465722f77702d6d6967726174652d64622e706e67) Description ----------- [](#description) WP Sync DB exports your database as a MySQL data dump (much like phpMyAdmin), does a find and replace on URLs and file paths, then allows you to save it to your computer, or send it directly to another WordPress instance. It is perfect for developers who develop locally and need to move their WordPress site to a staging or production server. ### Selective Sync [](#selective-sync) WP Sync DB lets you choose which DB tables are migrated. Have a huge analytics table you'd rather not send? Simply deselect it and it won't be synced. ### Bi-directional Sync [](#bi-directional-sync) #### Pull: Replace a Local DB with a Remote DB [](#pull-replace-a-local-db-with-a-remote-db) If you have a test site setup locally but you need the latest data from the production server, just install WP Sync DB on both sites and you can pull the live database down, replacing your local database in just a few clicks. #### Push: Replace a Remote DB with a Local DB [](#push-replace-a-remote-db-with-a-local-db) If you're developing a new feature for a site that's already live, you likely need to tweak your settings locally before deploying. Once you've perfected your configuration on your development machine, it's easy to send the settings to your production server. Just push to the server, replacing your remote database with your local one. ### Database Export & Backup [](#database-export--backup) Not only can WP Sync DB pull and push your DB: it can export your DB to an SQL file that you can save and backup wherever you want. No need to ssh into your machine or open up phpMyAdmin. ### Encrypted Transfers [](#encrypted-transfers) All data is sent over SSL to prevent your database from being read during the transfer. WP Sync DB also uses HMAC encryption to sign and verify every request. This ensures that all requests are coming from an authorized server and haven't been tampered with en route. ### Automatic Find & Replace [](#automatic-find--replace) When migrating a WordPress site, URLs in the content, widgets, menus, etc need to be updated to the new site's URL. Doing this manually is annoying, time consuming, and very error-prone. WP Sync DB does all of this for you. ### Media migration [](#media-migration) WP Sync DB can also migrate media files between WordPress installations, the module is now integrated into the main plugin. It will automatically copy media files from the source to the destination during a migration, ensuring that all media is up-to-date and consistent across installations. ### Stress Tested on Massive Sites [](#stress-tested-on-massive-sites) Huge database? No prob. WP Sync DB has been tested with tables several GBs in size. ### Detect Limitations Automatically [](#detect-limitations-automatically) WP Sync DB checks both the remote and local servers to determine limitations and optimize for performance. For example, we detect the MySQL `max_allowed_packet_size` and adjust how much SQL we execute at a time. ### Sync Media Libraries Between Installations [](#sync-media-libraries-between-installations) Using the optional [WP Sync DB Media Files](https://github.com/jsongerber/wp-sync-db-media-files) addon, you can have media files synced between installs too. Installation ------------ [](#installation) ### Using composer [](#using-composer) If you manage your WordPress site using composer (e.g. with [Bedrock](https://roots.io/bedrock/)), you can install WP Sync DB using the following command: ``` composer require jsongerber/wp-sync-db ``` ### Using git-updater [](#using-git-updater) 1. Install [git-updater](https://github.com/afragen/git-updater) by downloading the latest zip [here](https://github.com/afragen/git-updater/releases). We rely on this plugin for updating WP Sync DB directly from this git repo. 2. Activate git-updater, then go to Settings > Git Updater. 3. If asked, enter your license key or click "Activate Free Version". 4. Go to the "Install Plugin" tab. 5. Enter "" in the "Plugin URI" field, you can leave the other fields blank. 6. Click "Install Plugin" and wait for the confirmation message. 7. Click the "Activate Plugin" link that appears after installation. ### Manual installation (not recommended) [](#manual-installation-not-recommended) > \[!WARNING\] This method is not recommended, as you will not receive automatic updates. 1. Download the zip from the [latest release](https://github.com/jsongerber/wp-sync-db/releases/latest). > \[!NOTE\] You must choose the "wp-sync-db-x.x.x.zip" file, not the "source code" zip. 2. Upload the zip to your WordPress site via the Plugins > Add New > Upload Plugin menu. 3. Activate the plugin. Usage ----- [](#usage) Once installed, you can access WP Sync DB from the Tools > WP Sync DB menu in your WordPress admin dashboard. From there, you can create migration profiles, perform migrations, and manage your database syncs. ### WP Cli [](#wp-cli) To use WP Sync DB via WP-CLI, you must first create a migration profile in the WP Sync DB admin interface. Once you have a profile set up, you can get its id by going to the "Migrate" tab in the WP Sync DB admin interface. The profile number is displayed next to the profile name. Or you can use the WP-CLI command to list all profiles: ``` wp wpsdb profiles ``` Once you have the profile number, you can run the migration using the following command: ``` wp wpsdb migrate [profile-number] ``` Localization ------------ [](#localization) WP Sync DB is localized using `gettext` and includes the following languages: - English (default) - French (fr\_FR) The CLI part of the plugin is only available in English, no translations will be added. If you'd like to add your language, please fork the repo and submit a pull request with your translation files in the `languages` folder, keep in mind that this plugin is intended for developers, and keeping standard technical terms in English is preferred, unless there is a widely accepted translation for them. Similar Tools ------------- [](#similar-tools) - [Interconnect IT's Search & Replace](https://github.com/interconnectit/Search-Replace-DB) Isn't this the same as WP Migrate DB Pro? ----------------------------------------- [](#isnt-this-the-same-as-wp-migrate-db-pro) No, of course not, don't be silly. I took out the license verification code, a really shady looking PressTrends reporter, and the tab for installing the Media Files addon before I published 1.4. Release 1.3 was the same as [WP Migrate DB Pro](https://deliciousbrains.com/wp-migrate-db-pro), but I've made several improvements since then. Is this Illegal? ---------------- [](#is-this-illegal) **No.** Just because this is based on the paid-for WP Migrate DB Pro, it doesn't mean I can't release it. WP Migrate DB Pro is released under GPLv2, a copyleft license that guarantees my freedom (and the freedom of all users) to copy, distribute, and/or modify this software. I *was* forced to rename it from "WP Migrate DB" to "WP Sync DB" after Delicious Brains decided to trademark the name "WP Migrate DB", [filed a DMCA takedown](http://wptavern.com/dmca-takedown-notice-issued-against-fork-of-wp-migrate-db-pro) against the repo, and threatened to take me to court. But they should be OK with it now. ### Health Score 41 — FairBetter than 89% of packages Maintenance60 Regular maintenance activity Popularity30 Limited adoption so far Community16 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~36 days Recently: every ~15 days Total 14 Last Release 255d ago Major Versions v1.6.7 → v2.0.02025-07-06 ### Community Maintainers ![](https://www.gravatar.com/avatar/28af4d5ccd617fd0e5a2639dd0455fd9a0ae01059ec7cdb33cf3740f228842d1?d=identicon)[jsongerber](/maintainers/jsongerber) --- Top Contributors [![notslang](https://avatars.githubusercontent.com/u/1049204?v=4)](https://github.com/notslang "notslang (52 commits)")[![jsongerber](https://avatars.githubusercontent.com/u/18051702?v=4)](https://github.com/jsongerber "jsongerber (52 commits)")[![bradt](https://avatars.githubusercontent.com/u/190095?v=4)](https://github.com/bradt "bradt (19 commits)")[![zamoose](https://avatars.githubusercontent.com/u/862531?v=4)](https://github.com/zamoose "zamoose (2 commits)")[![etcook](https://avatars.githubusercontent.com/u/2329397?v=4)](https://github.com/etcook "etcook (2 commits)")[![jaredh159](https://avatars.githubusercontent.com/u/7050938?v=4)](https://github.com/jaredh159 "jaredh159 (1 commits)")[![joshlevinson](https://avatars.githubusercontent.com/u/2895131?v=4)](https://github.com/joshlevinson "joshlevinson (1 commits)")[![ipmidev](https://avatars.githubusercontent.com/u/13798481?v=4)](https://github.com/ipmidev "ipmidev (1 commits)")[![fahrenheit451fra](https://avatars.githubusercontent.com/u/45125765?v=4)](https://github.com/fahrenheit451fra "fahrenheit451fra (1 commits)")[![dseguy](https://avatars.githubusercontent.com/u/170418?v=4)](https://github.com/dseguy "dseguy (1 commits)") --- Tags pluginwordpressdbwp-sync-db ### Embed Badge ![Health badge](/badges/jsongerber-wp-sync-db/health.svg) ``` [![Health](https://phpackages.com/badges/jsongerber-wp-sync-db/health.svg)](https://phpackages.com/packages/jsongerber-wp-sync-db) ``` ### Alternatives [tareq1988/wp-eloquent Eloquent ORM for WordPress 57254.7k](/packages/tareq1988-wp-eloquent)[wp-sync-db/wp-sync-db-media-files WP Sync DB Media File Addon for WP Sync DB 535151.4k](/packages/wp-sync-db-wp-sync-db-media-files)[mdsimpson/contact-form-7-to-database-extension Plugin that saves contact form submissions to your WordPress database and provides and administration page and shortcodes to view and display the data. 24016.8k](/packages/mdsimpson-contact-form-7-to-database-extension)[dbout/wp-orm WordPress ORM with Eloquent. 1279.6k1](/packages/dbout-wp-orm)[pixelstudio/wp-sync-db WordPress plugin to sync database between different installs 472.5k1](/packages/pixelstudio-wp-sync-db) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)