Project Configuration

A project is the main starting point to use derex.

It can define custom packages (like xblocks) to install, themes, database fixtures and plugins.

A minimal Project

The bare minimum project is a directory with a single yaml file in it, stating the project name.

For example, the minimal project included with derex.runner looks like this:

├─ derex.config.yaml

The yaml file contents are:

project_name: minimal

Custom requirements

Additional requirements need to be specified in a requirements directory.

TODO expand this section

Custom settings

A settings directory can be added to the project, containing files that can be used as django settings for the LMS/CMS.

TODO expand this section


A common need is to be able to share a configuration value among all containers.

The project config file can specify variables that will be passed on to all containers, including ones defined by plugins.

For each defined variable you need to specify the value it should have for each possible settings value.

For instance the following config will drive the variable DEREX_LMS_SITE_NAME.


In turn the default derex config files for LMS will look into all environment variables of the form DEREX_LMS_VARIABLE_NAME and set the settings value VARIABLE_NAME accordingly.


A project can be in one of two runmodes: debug or production.

In debug mode the Open edX servers are run with the Django runserver command, while in production gunicorn is used.

Custom docker-compose.yml

If a file named docker-compose.yml is present in the project directory, it will be appended to the derex configuration.

Additionally, a docker compose can be specified for each runmode (production or debug) with the filename docker-compose-production.yml or docker-compose-debug.yml.