Customizing appearance on 1-click AWS install

Site Operators Site Operations Help
,
1

Hello
I installed Tutor from AMI on AWS using the 1-click install (t3.large instance with 500 GB storage), setup DNS, created super user and imported demo course. All working flawlessly.

Then I’d like to customize theme so I :

  • forked GitHub - overhangio/tutor-indigo: An elegant, customizable theme for Open edX to my own repo
  • replaced all instances of “indigo” with my theme name everywhere needed
  • ssh’ed into the instance
  • tutor local stop
  • tutor plugins disable indigo
  • went to plugins folder and cloned my forked repo
  • located the virtual env pip command and used it to pip install -e . in the plugin folder
  • tutor plugins enable mypluginname
  • tutor images build openedx
  • tutor local launch

But this last command fails, crying for an mfe image with the suffixed -mypluginname.
I tried to tutor images build mfe but this fails after 458 seconds without any error message…

Thanks for any help you can provide

2

@jhor welcome to the community!

@tutor-maintainers any advice here?

3

Are you able to provide any additional logs from when you tried these steps?

I’ve tried also modifying indigo to change the name of the theme (can’t recall exactly what I did to make it work as this was quite long ago) but ultimately found it to be too much a chore to keep updated, I ended up just keeping the indigo theme as-is but simply replacing any icons/templates as I saw fit, this has been a much simpler route for me to just replace a few image files and such…

4

This is a tough one since there aren’t any logs. But, I can guess a little from what might be failing considering it took 458 secs to fail.

Looking at this:

Did you also replace the indigo name in the extra npm packages being installed? These packages are published to npm with this exact name and the image build would fail if the packages can’t be found on a registry.

If that is not the case, then it is possible the MFE image build might be failing because of the concurrent network connections (a common problem with the MFE image build). For this, you can try out the steps mentioned in these docs: tutor-indigo/tutorindigo/plugin.py at release · overhangio/tutor-indigo · GitHub.

5

This is what you need to fix. You really need to re-build the “mfe” image. But doing that might be failing because you don’t have enough memory. My bet is that you are facing this issue: Troubleshooting — Tutor documentation

So I suggest the following:

  1. Customise your Docker builder, as suggested above
  2. Rebuild the mfe image, with tutor images build mfe
  3. tutor local launch
  4. Don’t forget to leave a review on the AWS marketplace if you’re happy with the result :slight_smile:
6

Many thanks to all for your help.
I was cautious in replacing indigo everywhere, and the reason for failure was indeed the mfe image not building for memory reasons.
We ended up going another way but thanks everyone for the support.
JH