Error Facing While Changing Logos in Tutor Open edX

Site Operators Site Operations Help
, ,
1

Error Facing While Changing Logos in Tutor Open edX

Issue Description

After following all the standard steps to update the logo image on the Tutor Open edX platform, the system does not update to use the new hashed images. Even after rebuilding assets, collecting static files, and restarting the environment, the platform continues to serve the old logo image.

Steps Followed to Change the Logo

Step 1: Copy the new logo image to the VM

Run this in PowerShell on your local machine:

scp -i "$env:USERPROFILE\Downloads\Rp2LMSTrialVM_key.pem" "$env:USERPROFILE\Downloads\rp-logo.png" azureuser@192.0.2.123:~

Step 2: Replace the existing logo inside the VM

SSH into your VM and run:

cp ~/rp-logo.png ~/.local/share/tutor/env/build/openedx/themes/indigo/lms/static/images/logo.png

Step 3: Rebuild and collect static assets

Inside the VM, run the following commands:

# Enter LMS container bash
tutor local run lms bash

# Inside container shell
npm install --legacy-peer-deps
npm run build
exit

# Collect static files
tutor local run lms bash -c "python manage.py lms collectstatic --noinput"

# Restart Tutor environment
tutor local restart

Step 4: Verify the hashed logo image

Check for updated hashed logo image inside the VM:

tutor local run lms bash -c "ls -lh --full-time /openedx/staticfiles/indigo/images/logo.*.png"

Problem

  • The hashed image filename does not change after these steps.
  • The timestamp on the hashed image does not update.
  • The front-end continues to serve the old logo image, despite replacing the file and running all build/collectstatic commands.
  • Browser cache clearing or hard refresh does not reflect the new logo.
2

Hi @sravan123
Are these ChatGPT instructions or were you following an already established guide? I’d recommend looking at the customisation instructions for Indigo as it seems that’s the base you’re starting from.

Steps:

  1. login to your server via SSH
  2. change directory to your plugins folder: cd $(tutor plugins printroot)
  3. download a fork of indigo: git clone https://github.com/overhangio/tutor-indigo.git
  4. make your modifications to the image files in the fork:
    a) $(tutor plugins printroot)/tutor-indigo/tutorindigo/templates/indigo/lms/static/images/{logo.png,favicon.ico}
    b) $(tutor plugins printroot)/tutor-indigo/tutorindigo/templates/indigo/cms/static/images/{studio-logo.png,favicon.ico}
  5. from your plugins root directory, run pip install -e ./tutor-indigo to install your modified clone into your Python
  6. enable the plugin and rebuild:
    a) tutor plugins enable indigo
    b) tutor config save
    c) tutor images build openedx --no-cache (no-cache switch isn’t always needed but I tend to use it anyway)
    d) restart your server instance: tutor local stop && tutor local start -d
  7. finally, enable your theme: tutor local do settheme indigo