https://packagist.org/packages/nauhyuh/flarum-migration-tool
If you’re running a Flarum forum and need a smoother way to back up or migrate your entire site from one server to another, the Flarum Migration Tool by nauhyuh is worth a close look. It’s a dedicated extension designed to take the stress out of forum migrations and system backups with both a friendly admin UI and solid safety features.
🔧 What Is It?
nauhyuh/flarum‑migration‑tool is a Flarum extension that provides a complete migration and backup solution directly within your forum’s admin dashboard. Think of it as a one‑stop tool for safely copying or moving your entire Flarum installation — including database and files — without having to manually export, upload, and configure everything yourself.
It’s built to support Flarum v1.0+ and is released under the MIT License.
🛠️ Key Features
This extension comes with several handy capabilities:
1‑Click Full Backup — Create a ZIP of your entire forum, including database, config, and uploads, with a single click.
Real‑Time Admin UI — A visually clear interface with a progress bar lets you track migration or backup progress in real time.
Safety‑First Workflow — During migration, existing site files are renamed with an _old suffix until you confirm everything is correct.
Smart Field Pre‑Filling — The tool can automatically detect your current server’s URL and database settings to speed up restoration.
Flexible Backup Options — Choose whether to include the vendor directory, user uploads, or even the config.php file in your backup.
Robust Database Export/Import — A pure‑PHP database engine ensures maximum compatibility across hosting environments.
Post‑Migration Cleanup — After you’ve verified your new site works correctly, you can safely remove the old files.
Command‑Line Support — Advanced users can also perform migrations via CLI (php flarum migration:migrate).
🚀 How It Works
Install the Extension
Run in your Flarum project:
composer require nauhyuh/flarum-migration-tool
Then enable it in the admin dashboard.
Create a Backup on Your Source Server
Use the Backup tab in the admin UI to generate a ZIP file of your forum data.
Restore or Migrate on the New Server
Install the extension there, upload the backup ZIP, and follow the on‑screen steps. The tool will optionally back up existing files with safe renaming before restoring.
Clean Up Old Files
After confirming everything works, you can delete the old backup files from your server.
🔐 Safety & Requirements
Works with Flarum v1.0+.
Requires PHP’s zip extension.
The server must have write permissions for key directories.
All actions are protected by Flarum’s admin authorization layer.
