Skip to content
Export legacy forums into a format Vanilla Forums can import.
Find file
New pull request

Vanilla Porter

Vanilla Porter is a nifty tool for exporting your old & busted forum into a fresh Vanilla Forum. It will create a zipped text file that can be imported directly to Vanilla via the Dashboard.

Do NOT user Vanilla Porter for UPGRADING. It is for migrating from other forums, including the incompatible Vanilla 1.x series.


Porter requires PHP 5.3+ and a connection to your existing database. That's it!

Getting started

Please use the official release, which is a single file. View the official documentation for important usage notes.

If you have a PHP-based forum (vBulletin, phpBB, etc) you can likely drop this right on your server and run it from there. For more complicated arrangements (like jForum, i.e. a Java environment), we suggest exporting your database to a PHP/MySQL server and running it there.

Roll your own!

To support a new forum source, copy "sample_package.php", rename it to your platform, put it in the packages folder, and follow its inline documentation.

You can run Vanilla Porter via index.php which will use the source files rather than the single-file official release. This makes it easier to keep it up-to-date and debug problems.

Send us a pull request when it's ready, and sign our contributor's agreement (requires a forum account).

Command line support

Porter can run via the command line. Execute the index.php file with the --help flag for a full list of options.

For developers with very large databases or ones still in production, we recommend running your export from the command line on your localhost environment with a copy of the database. It just makes life easier.

Building a release

Run make.php, which will build a single file named vanilla2export.php. Easy peasy.

Something went wrong with that request. Please try again.