Debug Open edX errors

Locate log files

NOTE: This section describes the log files location for the edX Eucalyptus release. If you are using a prior version, find the log files at /opt/bitnami/apps/edx/edxapp/log/.

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/.

By default, both services are configured with a “local” log level. If you want to increase the log level on each service in order to debug your application, you need to follow the steps below:

  • Open the log configuration files with an editor. Depending on the service, you will find that files at:

    • edx platform: /opt/bitnami/apps/edx/conf/cms.env.json and /opt/bitnami/apps/edx/conf/lms.env.json.
    • XQueue: /opt/bitnami/apps/xqueue/conf/xqueue.env.json.
  • Substitute the value:


  • with:


  • Restart the Apache server to load the changes.

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