Migrate the Theme

If you have custom theme developed for source Edx, then you can migrate your theming related changes as well as any changes related to functionality. For that, you need to use git client and git server. Git client is a tool you need to install on your Source Edx and Target Edx. While git server is a remote server usually provided by some Git vendors which includes Gitlab, Bitbucket and Manajor. Installing git client and configuring git server is out of scope. However, here we are using Manajor.

1. On your Source Machine, note the directory of your theme. Often, this is /edx/app/edxapp/themes/[theme_folder].

2. On your Target Machine, recreate that directory by copying the directory from the source machine. You can use scp, a remote repository e.g. Github.com, or some other method.

   Note: If you change the name of your theme, then you should search in your theme for any instances of your old theme name and replace them with your new theme name. For example, a line in your .sass file that says /static/old-theme/images/logo.jpg should become /static/my-theme/images/logo.jpg. You can do a recursive search through your theme by going into the directory with the theme and running:

grep -r "old-theme" my-theme/ 

3. Compile your theme Assets. (Note: You must make sure that ENABLE_COMPREHENSIVE_THEMING is enabled and COMPREHENSIVE_THEME_DIRS points to the directory that contains your theme.

sudo -H -u edxapp bash
source /edx/app/edxapp/edxapp_env
cd /edx/app/edxapp/edx-platform
paver update_assets lms cms --settings=aws

4. Log into your EdX instance with a superuser and navigate to /admin/theming/sitetheme/. Confirm that your site theme is configured correctly. The 'Theme Dir Name' should exactly match the name of your theme directory.

5. Check your website to confirm that the theme is correctly applied.