PHPackages nauhyuh/flarum-migration-tool - 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. nauhyuh/flarum-migration-tool ActiveFlarum-extension[Database & ORM](/categories/database) nauhyuh/flarum-migration-tool ============================= Complete migration tool with admin UI for easy Flarum server transfer. Backup, restore, and migrate your forum with just a few clicks. 2.4.1(3mo ago)1103—0%MITPHP Since Jan 30Pushed 3mo agoCompare [ Source](https://github.com/nauhyuh/flarum-migration-tool)[ Packagist](https://packagist.org/packages/nauhyuh/flarum-migration-tool)[ Docs](https://github.com/nauhyuh/flarum-migration-tool)[ GitHub Sponsors](https://github.com/sponsors/nauhyuh)[ RSS](/packages/nauhyuh-flarum-migration-tool/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (2)Versions (15)Used By (0) Flarum Migration Tool 🚀 ======================= [](#flarum-migration-tool-) A professional, safety-first migration and backup extension for Flarum. Transfer your forum between servers or create full-system backups with ease, all through a beautiful real-time Admin UI. [![Version](https://camo.githubusercontent.com/aa9086136fd59914dcba19f00b58162f07f5cea6293213b4a2e9423bc690139a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d322e342e302d626c75652e737667)](https://camo.githubusercontent.com/aa9086136fd59914dcba19f00b58162f07f5cea6293213b4a2e9423bc690139a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d322e342e302d626c75652e737667)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)[![Flarum](https://camo.githubusercontent.com/14bb5bcd16d2c565088bf58fcdf43a4024354ac4e8cb97c0bee658e04b152917/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d636f726525323076312e302b2d6f72616e67652e737667)](https://camo.githubusercontent.com/14bb5bcd16d2c565088bf58fcdf43a4024354ac4e8cb97c0bee658e04b152917/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d636f726525323076312e302b2d6f72616e67652e737667) ✨ Key Features -------------- [](#-key-features) - **1-Click Full Backup**: Zip your entire Flarum site, including database, settings, and files. - **Safety-First Migration**: Existing server files are renamed with an `_old` suffix during migration. Data is never lost until you verify and click "Cleanup". - **Real-time Progress Bar**: Track every step of your backup or migration with detailed status labels and percentage updates. - **Smart Pre-filling**: Automatically detects your current server's URL and database credentials to save time during migrations. - **Flexible Options**: - Include/Exclude `vendor` directory. - Include/Exclude user uploads (avatars, attachments). - Include/Exclude `config.php` (sensitive credentials) in backups. - **Robust DB Engine**: Pure PHP database export/import engine designed for maximum compatibility across different hosting environments. - **Post-Migration Cleanup**: Dedicated tool to permanently remove old files once you've confirmed your new site is working perfectly. - **Command Line Support**: Advanced users can still perform migrations via `php flarum migration:migrate`. 🛠 Installation -------------- [](#-installation) Install the extension via Composer: ``` composer require nauhyuh/flarum-migration-tool ``` After installation, enable the extension in your Flarum Admin dashboard. 🚀 How to Migrate ---------------- [](#-how-to-migrate) ### Step 1: Create a Backup on Source Server [](#step-1-create-a-backup-on-source-server) 1. Go to **Admin > Migration Tool > Backup** tab. 2. Select your desired options (Exclude `vendor` for smaller files). 3. Click **Create Backup**. Watch the real-time progress bar. 4. Once finished, click **Download** to save the ZIP to your computer. ### Step 2: Restore on Destination Server [](#step-2-restore-on-destination-server) 1. Install this extension on your new Flarum site. 2. Go to **Admin > Migration Tool > Migrate** tab. 3. Upload your ZIP backup file. 4. The tool will auto-fill your current server's DB details. Update if you are migrating to a different database. 5. Click **Start Migration**. The tool will: - Backup existing files to `*_old`. - Replace the database. - Restore your files. 6. Check your site. If everything is perfect, click **Cleanup Old Files** to delete the `_old` items. 📋 Requirements -------------- [](#-requirements) - Flarum v1.0+ - PHP `zip` extension enabled. - Write permissions for `storage` and root directories. - MySQL/MariaDB database. 🛡 Security & Safety ----------------------- [](#-security--safety) - **No Data Deletion**: Migrations use high-level safety renaming. Your old files are kept safe as `_old` until you choose to delete them. - **Cleanup Tool**: Ensures no sensitive `_old` files (like `config.php_old`) are left on your server publicly. - **Admin Only**: All migration routes are strictly protected by Flarum's admin authorization. 📄 License --------- [](#-license) This project is licensed under the MIT License. --- **Crafted with ❤️ by Nauhyuh** ### Health Score 37 — LowBetter than 83% of packages Maintenance81 Actively maintained with recent releases Popularity14 Limited adoption so far Community2 Small or concentrated contributor base Maturity42 Maturing project, gaining track record 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 ~0 days Total 14 Last Release 102d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5878d5a426705507383cdbbbb9b088990b07f9144e2d5094c65314587f2e7dcc?d=identicon)[nauhyuh](/maintainers/nauhyuh) --- Tags migrationbackupextensionrestoretransferflarumadmin-uiserver migration ### Embed Badge ![Health badge](/badges/nauhyuh-flarum-migration-tool/health.svg) ``` [![Health](https://phpackages.com/badges/nauhyuh-flarum-migration-tool/health.svg)](https://phpackages.com/packages/nauhyuh-flarum-migration-tool) ``` ### Alternatives [rah/danpu Zero-dependency MySQL dump library for easily exporting and importing databases 64401.8k10](/packages/rah-danpu)[c006/yii2-migration-utility Automatically writes the create tables for migrations or create tables in general 63160.6k1](/packages/c006-yii2-migration-utility)[dragon-code/migrate-db Easy data transfer from one database to another 15717.4k](/packages/dragon-code-migrate-db)[dmstr/yii2-migrate-command Console Migration Command with multiple paths/aliases support 31295.5k6](/packages/dmstr-yii2-migrate-command)[hzhihua/yii2-dump Generate the schema from an existing database 1828.5k1](/packages/hzhihua-yii2-dump)[spanjeta/yii2-backup Database Backup and Restore functionality 285.0k1](/packages/spanjeta-yii2-backup) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)