Modify the interface language

Open edX uses Transifex, an open source translation platform, to power the translation of edX software into different languages. All translations are hosted at, which provides a web application allowing translators to write, submit, and manage their translations.

In order to change the language, follow the steps below:

  • Sign up and join the edX platform Transifex project as a translator. See the Transifex documentation for help with Transifex.

  • Log in to the server console.

  • Install the GCC compiler.

    • On Debian/Ubuntu, run the commands below:

        $ sudo apt-get update
        $ sudo apt-get install gcc g++
    • On RHEL/CentOS, run the commands below:

        $ sudo yum group install "Development Tools"
  • Install Python dependencies:

      $ pip install transifex-client
  • Create the ~/.transifexrc file and set your credentials as follows:

      hostname =
      username = USER
      password = PASS
      token =

    NOTE: Remember to replace the USER and PASS placeholders in the previous example with your Transifex credentials.

  • Make sure that all languages you wish to download are present and uncommented in the /opt/bitnami/apps/edx/edx-platform/conf/locale/config.yaml.

  • Set the value of the LANGUAGE_CODE variable to the language you desire (for example, set it to “es_es” to translate it to Spanish) in the configuration files:

    • /opt/bitnami/apps/edx/conf/cms.yml
    • /opt/bitnami/apps/edx/conf/lms.yml
    • /opt/bitnami/apps/edx/edx-platform/lms/envs/
  • Download the translations by running the commands below:

      $ cd /opt/bitnami/apps/edx/edx-platform
      $ sudo /opt/bitnami/apps/edx/bin/paver.edxapp i18n_robot_pull
  • Download the translation for the Forum by running the commands below:

      $ cd /opt/bitnami/apps/forum/cs_comments_service
      $ bundle install --with test
      $ bundle exec bin/rake i18n:pull
  • Restart the Apache server to load the changes.

You can find more information at the Open edX Internationalization and localization wiki page.

Last modification March 24, 2021