# Migrate a NodeBB forum with Redis to Discourse **URL:** \ **Category:** Sysadmins\ **Tags:** how-to\ **Created:** [August 5, 2019, 12:19pm UTC](https://meta.discourse.org/t/migrate-a-nodebb-forum-with-redis-to-discourse/124897 "2019-08-05T12:19:19Z")\ **Posts on this page:** 1\ **Showing post:** 1
**Author:** ![enigmaty](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/enigmaty/32/65626_2.png) [@enigmaty](https://meta.discourse.org/u/enigmaty)\ **Post date:** [August 5, 2019, 12:19pm UTC](https://meta.discourse.org/t/migrate-a-nodebb-forum-with-redis-to-discourse/124897/1 "2019-08-05T12:19:19Z")
This tutorial will show you how to use the [NodeBB Importer](https://github.com/discourse/discourse/blob/master/script/import_scripts/nodebb/nodebb.rb) to migrate NodeBB forum to Discourse platform. If your NodeBB forum uses MongoDB as backend then follow [this tutorial](https://meta.discourse.org/t/importing-nodebb-mongodb-to-discourse/126553). Do not worry, It is an easy process. Let’s get started. ### The plan - Preparing the development environment. - Export database from production environment. - Import the production DB to a Discourse instance. - Run the importer script. ### What data can be migrated? - Groups - Categories - Root Category =\> Root Category - Sub Category & Sub-Sub-Category =\> Sub-Category - Attachments - Topics & Posts - pinned topic =\> pinned topic - topic views - all styles will be migrated just fine with mentions, emoji, and attachments. - Users (with following attributes) - avatars (profile picture) - profile background - banned status - name - username - email - bio - admin - website - location - joining at status - group ### Preparing Local Development Environment Set up your development environment by following one of these guides: - [Ubuntu](https://meta.discourse.org/t/beginners-guide-to-install-discourse-on-ubuntu-for-development/14727) - [Windows 10](https://meta.discourse.org/t/beginners-guide-to-install-discourse-on-windows-10-for-development/75149) - [Mac OS](https://meta.discourse.org/t/beginners-guide-to-install-discourse-on-mac-os-x-for-development/15772) From now on I will be referring to this environment as _Discourse server_ > πŸ’‘ Please, use [this guide](https://github.com/discourse/discourse/blob/master/docs/TROUBLESHOOTING.md) if you have any trouble setting up Discourse. ### Exporting Production Database Dump (from NodeBB Server): Shut down your forum. This recommended by NodeBB ```plaintext $ cd /path_to_nodebb $ ./nodebb stop ``` You should also shut down Redis: ```plaintext $ sudo service redis-server stop $ sudo service redis-server status # redis-server is not running ``` Your DB forum is all in one file. This file is auto-generated periodically by Redis. Usually this file is located in `/var/lib/redis/dump.rdb`. Also, you can get the path from Redis CLI: ```plaintext $ redis-cli 127.0.0.1:6379> config get dir # "/var/lib/redis" 127.0.0.1:6379> exit $ ls -la /var/lib/redis # -rw-rw-r-- 1 redis redis 2664346 Aug 4 16:24 dump.rdb ``` > πŸ’‘ If your Redis server requires password use `AUTH YOUR_PASSWORD` > πŸ’‘ If for some reason you did not find your DB file in the expected path, you can generate it manually by running `SAVE` inside Redis CLI. Now you need to copy the forum attachments: ```plaintext $ cd /path_to_nodebb_root_folder/ $ tar -czf ./uploads.tar.gz ./public/uploads ``` Now that you have your DB and forum assets you need to copy them to _Discourse server_. ### Importing The Database If you follow the instructions in installing Discourse you should have Redis server installed on _Discourse server_: ```plaintext $ redis-server -v # Redis server v=5.0.2... ``` Now you need to stop Redis server (important). Linux based: ```plaintext $ sudo service redis-server stop $ sudo service redis-server status # redis-server is not running ``` Mac OS: ```plaintext $ brew services stop redis $ brew services list # redis stopped ``` What you need to do now is to copy the DB forum to our local Redis DB path. The importer needs to connect to Redis server and migrate the NodeBB DB to Discourse DB. This step assumes that you do not have anything important on your Redis DB, otherwise you should perform a backup. ```plaintext $ redis-cli 127.0.0.1:6379> config get dir # "/var/lib/redis" ``` Check if there are any files and take note about the current user and permission of dump.rdb: ```plaintext $ ls -la /var/lib/redis ``` Copy the NodeBB DB (replace if there is one): ```plaintext $ cp dump.rdb /var/lib/redis ``` Later when trying to connect to Redis server you may get `Fatal error loading the DB: Permission denied`, therefore you should alter the permission of dump.rdb: ```plaintext # Replace the user with same as the note you take previously. $ sudo chown redis:redis /var/lib/redis/dump.rdb $ sudo chmod 660 /var/lib/redis/dump.rdb ``` Now you need to untar the uploads.tar.gz to any path of your choice: ```plaintext $ tar xvzf uploads.tar.gz ``` ### Running The Importer Script Now that our database in place we are ready to run our importer script. Before that, we need to edit some configuration. You properly need to change just the following two lines. This is the path of your NodeBB uploads folder: ```plaintext ATTACHMENT_DIR = '/absolute_path/uploads' ``` This is the name of DB in Redis. The default is `0`: ```plaintext db: 0 ``` Run the importer with clean Discourse: ```plaintext $ cd ~/discourse $ bundle exec rake db:drop db:create db:migrate $ bundle exec ruby script/import_scripts/nodebb/nodebb.rb ``` The importer will connect to the Redis server and migrate everything to Discourse Postgresql DB. After the importer finishes, start Discourse platform: ```plaintext $ bundle exec rails server ``` Start Sidekiq to process the migrated data: ```plaintext $ bundle exec sidekiq ``` You can monitor the progress at `http://localhost:3000/sidekiq/queues`. Perform a Discourse backup and upload it to your Discourse production server by following this [tutorial](https://meta.discourse.org/t/move-your-discourse-instance-to-a-different-server/15721). By that, you should have successfully made a full migration from Nodebb to Discourse πŸŽ‰ Please, if you have any questions I am happy to help πŸ™‚ --- _[View the full topic](https://meta.discourse.org/t/migrate-a-nodebb-forum-with-redis-to-discourse/124897)._