Debug Open edX errors

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

Locate log files

The Open edX log files are stored at different paths depending on the service:

  • edX Platform log files are stored at installdir/apps/edx/var/log.
  • XQueue log files are stored at installdir/apps/xqueue/var/log.

Increase the log level in Open edX Hawthorn.2 and later

By default, both services are configured with an “info” log level. To increase the log level on each service in order to debug your application, follow the steps below:

  • Open the edX Platform configuration files installdir/apps/edx/conf/cms.env.json and installdir/apps/edx/conf/lms.env.json with an editor, and substitute the value:


    with this:

  • Open the XQueue configuration file installdir/apps/xqueue/conf/xqueue.yml, change the following value:

  • with:

  • Restart the Apache server and edX services to load the changes.

    $ sudo installdir/ restart apache
    $ sudo installdir/ restart edx
    $ sudo installdir/ restart xqueue

Troubleshoot errors sending bulk email

You may encounter errors sending bulk email from the instructor tab. This is usually because the bulk email subsystem requires the Lynx plaintext browser to convert HTML email to plaintext (discussed at

To resolve this, install the Lynx browser using the command below:

  • Debian:

    $ sudo apt-get install lynx
  • CentOS:

    $ sudo yum install lynx
Last modification April 8, 2020