Setup Guide

Prerequisites

• Open edX (Hawthorn or Ironwood) instance.(Installation link)
• NodeBB (v1.10.x or above) instance. (Installation link)

Note: For other releases of Open edX, please visit this link

Steps

Devstack Setup

You can either use opendx-devstack and apply all configurations yourself or you can simply use the pre-configured openedx-nodebb-devstack.

Using openedx-devstack

• Configure your fresh edX devstack instance using configure edX repo of openedx_edly_discussion wiki.
• Generate a master token for API access of NodeBB using this link.
• Follow the Installation guide steps of nodebb-plugin-openedx-discussion to integrate nodebb-plugin-openedx-discussion plugin in your NodeBB instance.

Using openedx-nodebb-devstack

• Just follow this link and you are done.

Sync already created users and courses of edX with NodeBB

Run following shell commands from devstack directory.

$ make lms-shell
$ ./manage.py lms sync_course_enrollments_with_nodebb
$ exit

$ docker-compose restart lms

Enable Discussion in a Course:

• Open your desired course from Studio.
• Go to Advanced Settings from the Settings tab of the Course.
• Add "openedx_edly_discussion" to the Advance module list and save it.