# Operation of the mfe

**URL:** <https://discuss.openedx.org/t/operation-of-the-mfe/15396>\
**Category:** Tutor Help\
**Created:** [March 31, 2025, 3:16am UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396 "2025-03-31T03:16:04Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Edwin75206](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/edwin75206/32/8134_2.png) [@Edwin75206](https://discuss.openedx.org/u/Edwin75206)\
**Post date:** [March 31, 2025, 3:16am UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/1 "2025-03-31T03:16:04Z")

</div>

I would like to get help. What happens is that I want to make a modification to the frontend-app-learning. I already cloned the repository on my machine, but now I want to know how I can make the settings I saved locally look. For example, I want my local to point to the cloned file instead of GitHub. I already tried, but now it shows me package errors. I already installed it in my mounts list. Could someone help me know how I can modify the frontend and how it works?

---

<div class="post-metadata">

**Author:** ![sarina](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/sarina/32/2308_2.png) [@sarina](https://discuss.openedx.org/u/sarina)\
**Post date:** [March 31, 2025, 1:52pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/2 "2025-03-31T13:52:35Z")

</div>

Hi @Edwin75206 and welcome to the community!

Have you searched the forums and tutor docs? What have you tried that isn’t working? What version of Tutor are you running?

[GitHub - overhangio/tutor-mfe: This plugin makes it possible to easily add micro frontend (MFE) applications on top of an Open edX platform that runs with Tutor.](https://github.com/overhangio/tutor-mfe) and these are the Tutor docs: [Getting started — Tutor documentation](https://docs.tutor.edly.io/gettingstarted.html)

---

<div class="post-metadata">

**Author:** ![Edwin75206](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/edwin75206/32/8134_2.png) [@Edwin75206](https://discuss.openedx.org/u/Edwin75206)\
**Post date:** [March 31, 2025, 2:41pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/3 "2025-03-31T14:41:04Z")

</div>

Hi @sarina , that’s exactly the one I’ve used. I’ve downloaded the GitHub repo of `frontend-app-learning`, and the Tutor version I’m using is 19.0.2. I think I’m also a bit confused about how to make the changes work. For example, I already have the GitHub version of `frontend-app-learning` in my Tutor setup, and I’ve made some changes. Now, how can I make those changes show up in production? How can I make Tutor stop pointing to the online GitHub repositories and instead point to my local modified version that I’ve already downloaded? Do you know how I could do that?

---

<div class="post-metadata">

**Author:** ![sarina](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/sarina/32/2308_2.png) [@sarina](https://discuss.openedx.org/u/sarina)\
**Post date:** [March 31, 2025, 8:32pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/4 "2025-03-31T20:32:57Z")

</div>

[@tutor-maintainers](https://discuss.openedx.org/groups/tutor-maintainers) is there documentation that can answer this question? If not, could we get an answer and figure out the right place to document this?

---

<div class="post-metadata">

**Author:** ![regis](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/regis/32/2640_2.png) [@regis](https://discuss.openedx.org/u/regis)\
**Post date:** [April 1, 2025, 6:29am UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/5 "2025-04-01T06:29:27Z")

</div>

You need to re-build the “mfe” Docker image with your changes, and then deploy it to production – exactly how depends on whether you are running `tutor local` or `tutor k8s`, whether you are building remotely or locally, etc.

This should be documented here: [GitHub - overhangio/tutor-mfe: This plugin makes it possible to easily add micro frontend (MFE) applications on top of an Open edX platform that runs with Tutor.](https://github.com/overhangio/tutor-mfe/) Documentation can always be improved. But at this point I’d rather spend my time fixing the MFE build process. The tutor-mfe plugin can only do so much, and can’t make up for the deficiencies of the microfrontend architecture.

---

<div class="post-metadata">

**Author:** ![sarina](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/sarina/32/2308_2.png) [@sarina](https://discuss.openedx.org/u/sarina)\
**Post date:** [April 3, 2025, 5:04pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/6 "2025-04-03T17:04:42Z")

</div>

> [@regis](#):
>
> You need to re-build the “mfe” Docker image with your changes, and then deploy it to production – exactly how depends on whether you are running `tutor local` or `tutor k8s`, whether you are building remotely or locally, etc.

@regis @arbrandes I am so happy to help improve the documentation but I’m not sure where to put the instructions. Would it be in this section: [https://github.com/overhangio/tutor-mfe/?tab=readme-ov-file#mfe-development](https://github.com/overhangio/tutor-mfe/?tab=readme-ov-file#mfe-development)? Where it says “in production the image will be rebuilt automatically during tutor dev launch”?

---

<div class="post-metadata">

**Author:** ![arbrandes](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/arbrandes/32/158_2.png) [@arbrandes](https://discuss.openedx.org/u/arbrandes)\
**Post date:** [April 3, 2025, 8:09pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/7 "2025-04-03T20:09:50Z")

</div>

Yes, I believe this would qualify as an improvement to the “MFE Development” section of the tutor-mfe README. Perhaps as a subsection of its own (“Deploying Changes to Production”?), since this is a question we get often.

Provided the modified codebase is mounted in the same machine where production deployment happens, it’s a matter of running `tutor images build mfe` and restarting your `local` deployment via `tutor local stop && tutor local start -d`.

But as Régis says, if the production deployment is on a different machine, or if using K8S, getting the image there will depend on the topology of the setup.

---

<div class="post-metadata">

**Author:** ![sarina](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/sarina/32/2308_2.png) [@sarina](https://discuss.openedx.org/u/sarina)\
**Post date:** [April 4, 2025, 3:27pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/8 "2025-04-04T15:27:53Z")

</div>

> [@arbrandes](#):
>
> Provided the modified codebase is mounted in the same machine where production deployment happens, it’s a matter of running `tutor images build mfe` and restarting your `local` deployment via `tutor local stop && tutor local start -d`.

@arbrandes I made a PR here for review: [Add section on deploying MFE changes to production by sarina · Pull Request #251 · overhangio/tutor-mfe · GitHub](https://github.com/overhangio/tutor-mfe/pull/251)

---

<div class="post-metadata">

**Author:** ![Edwin75206](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/edwin75206/32/8134_2.png) [@Edwin75206](https://discuss.openedx.org/u/Edwin75206)\
**Post date:** [April 5, 2025, 8:19pm UTC](https://discuss.openedx.org/t/operation-of-the-mfe/15396/9 "2025-04-05T20:19:51Z")

</div>

If I have the Tutor Indigo theme activated and installed, could that possibly cause issues when loading the MFEs I’ve modified on GitHub?
