MyBB to Flarum

Migrate a MyBB Forum to a fresh Flarum instance

Compatible with Flarum v1.3.0

Latest release v8.2


released on Jan 3, 2019


This is a Flarum extension to migrate data from a mybb forum to a fresh flarum instance.

image admin section

What can it migrate?

In your admin panel you can choose what to migrate.

  • Users (their passwords are ALL reset to a bcrypt hash from current time)
  • Categories
  • Forums
  • Posts
  • Groups
  • Avatars
  • Attachments (requires fof/upload)


This extension has been tested with MyBB v1.8.* and Flarum v1.*

Execute this command in the root of your flarum installation: composer require michaelbelgium/mybb-to-flarum. Navigate to your admin panel, enable the extension and you get a new link in the admin navigation bar.


you can trigger the migration from the admin panel or the console:

> php flarum migrate-data:from-mybb

  Migrates data from an existing mybb forum

  migrate-data:from-mybb [options]

      --host=HOST            host of the mybb database
  -u, --user=USER            user of the mybb database
  -p, --password[=PASSWORD]  password for the mybb database [default: ""]
  -d, --db=DB                name of the mybb database
      --prefix[=PREFIX]      prefix of the mybb database tables [default: "mybb_"]
      --users                Import users (excluding avatars)
      --threads-posts        Import posts (excluding soft deleted posts/threads)
      --groups               Import groups
      --categories           Import categories
      --avatars              Import avatars
      --path[=PATH]          Path to the mybb forum (required for avatar and attachment migration) [default: ""]
      --soft-posts           Import soft deleted posts
      --soft-threads         Import soft deleted threads
      --attachments          Import attachments
  -h, --help                 Display help for the given command. When no command is given display help for the list command   
  -n, --no-interaction       Do not ask any interactive question

Example commands

Migrate only users and avatars

> php flarum migrate-data:from-mybb --host= --user=homestead --password=secret --db=mybb --users --avatars --path=../mybb

Migrate everything (excluding avatars and soft deleted posts/threads)

php flarum migrate-data:from-mybb --host= --user=homestead --password=secret --db=mybb --users --groups --threads-posts

Migrate users with threads and posts including soft deleted threads but excluding soft deleted posts

php flarum migrate-data:from-mybb --host= --user=homestead --password=secret --db=mybb --users --threads-posts --soft-threads

Important notes

  • If u specify u want to migrate avatars then a path to your MyBB forum is required also.
  • Forums with a redirect hyperlink are skipped. Flarum doesn't support them (yet).
  • A guest who created a MyBB post or thread will appear as a deleted user in Flarum and not specifically a "guest".
  • The core BBcode extension should be enabled too.

© 2022 Hyn by DaniĆ«l "Luceos" Klabbers. All rights reserved. · Extensions and extension information is provided by the respective (copyright holding) authors. · Extiverse is not affiliated to the Flarum project or Flarum foundation. · Images on Extiverse pages are from Unsplash.