So you want to migrate your existing forum to Discourse? That’s great! Let’s get started!
We recommend setting up a development environment on your machine (or inside a virtual machine) and run the import there instead of inside the docker container. Then you will be able to create a backup and import it on your production instance. Refer the OS X or Ubuntu installation guide for development.
We highly recommend to read the script before performing import, as the script is meant for developers, and you will almost certainly need to modify the script file before beginning. Near the top of the scripts, a connection is made to the database containing the source data; so at a minimum, the connection settings will need to be changed. You may also want to change the SQL queries that fetch the data to import into Discourse. For example, if you want to exclude really old posts, you can add a condition to the where clauses.
After reviewing and modifying, to run the SomeForumSoftware import script you will do:
cd path/to/your/discourse_folder bundle exec ruby script/import_scripts/some_forum_software.rb
This process will be similar for other import scripts.
Discourse currently provides import scripts for a wide range of forum software, including Vanilla, phpBB3, SMF2, bbPress, VBulletin, and others.
Many of these scripts have dedicated tutorials. You can find them here.
The exhaustive list of import scripts is available under the script/import_scripts folder on GitHub.