Debug Open edX errors

Locate log files

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

  • edX Platform log files are stored at /opt/bitnami/apps/edx/var/log.
  • XQueue log files are stored at /opt/bitnami/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 /opt/bitnami/apps/edx/conf/cms.env.json and /opt/bitnami/apps/edx/conf/lms.env.json with an editor, and substitute the value:


    with this:

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

  • with:

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

    $ sudo /opt/bitnami/ restart apache
    $ sudo /opt/bitnami/ restart edx
    $ sudo /opt/bitnami/ 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