ashley 1.0.0

A self-hosted discussion forum for learning

Ashley, a self-hosted discussion forum for learning

Overview

Ashley is a forum designed to be integrated into Learning Management Systems (LMS).

It is a multi-tenant service intended to be operated independently. It can be integrated to any LMS (like Open edX or Moodle), thanks to the LTI standard.

Ashley is built on top of Django-machina, a powerful forum engine for Django.

Quick preview

Here is an example integration of Ashley in Open edX:

Contributing

This project is intended to be community-driven, so please, do not hesitate to get in touch if you have any question related to our implementation or design decisions.

We try to raise our code quality standards and expect contributors to follow the recommandations from our handbook.

License

This work is released under the MIT License (see LICENSE).

Getting started

Make sure you have a recent version of Docker and Docker Compose installed on your laptop:

$ docker -v
  Docker version 18.09.0, build 4d60db4

$ docker-compose --version
  docker-compose version 1.23.2, build 1110ad01

⚠️ You may need to run the following commands with sudo but this can be avoided by assigning your user to the docker group.

Project bootstrap

The easiest way to start working on the project is to use our Makefile :

$ make bootstrap

This command builds the app container, installs front-end and back-end dependencies, builds the front-end application and styles, and performs database migrations. It's a good idea to use this command each time you are pulling code from the project repository to avoid dependency-related or migration-related issues.

Now that your Docker services are ready to be used, start the service by running :

$ make run

You should be able to test the forum at http://localhost:8090/dev/. This is the development view that emulates a LTI consumer.

Django admin

You can access the Django admin site of the forum at http://localhost:8090/admin/

You first need to create a superuser account.

$ make superuser

Troubleshooting

ElasticSearch service out with an Exit 137

$ docker-compose ps

ashley_elasticsearch_1 /docker-entrypoint.sh elas ... Exit 137

This is due to a lack of memory. N.B. for Mac users, the default Docker's configuration is also 2GB which means that Elasticsearch will automatically exit.

To fix this issue, you need to upgrade your default configuration.