# How to use a customized mfe

**URL:** <https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782>\
**Category:** Development\
**Tags:** tutor\
**Created:** [May 12, 2025, 11:13am UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782 "2025-05-12T11:13:15Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![teklu](https://avatars.discourse-cdn.com/v4/letter/t/51bf81/32.png) [@teklu](https://discuss.openedx.org/u/teklu)\
**Post date:** [May 12, 2025, 11:13am UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/1 "2025-05-12T11:13:15Z")

</div>

Hi, everyone

I’m using Tutor to run Open edX, with the edx-platform cloned and mounted for development.

I have checked the mount list with

> tutor mounts list

shows mounts for openedx and openedx-dev images using the edx-platform context.

I launched the development environment with

> tutor dev launch

, and the MFE container (overhangio/openedx-mfe:19.0.0-indigo) is running, mapping multiple ports (e.g., 1997-\>8002/tcp). However, I want to use a locally customized ‘frontend-app-authn’ MFE that I’ve forked, cloned, and modified, instead of the default MFE image.

How can I configure Tutor to use my local ‘frontend-app-authn’ repository for the MFE instead of the default overhangio/openedx-mfe:19.0.0-indigo image?

Note: other mfe are running from overhangio/openedx-mfe, my intention is to do customization for each mfe individually and test. for that i want to know how to do that atlease for a single mfe.

Please any one who can help me with this.

---

<div class="post-metadata">

**Author:** ![braden](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/braden/32/46_2.png) [@braden](https://discuss.openedx.org/u/braden)\
**Post date:** [May 12, 2025, 4:45pm UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/2 "2025-05-12T16:45:49Z")

</div>

Hi @teklu,

The official documentation on how to do this is here: [Tutor MFE README " MFE development"](https://github.com/overhangio/tutor-mfe/?tab=readme-ov-file#mfe-development)

There is also an alternate method (running the MFE on your host instead of inside docker) that is available for on some MFEs, e.g. [here are the instructions for the authoring MFE](https://github.com/openedx/frontend-app-authoring?tab=readme-ov-file#getting-started).

Let us know if one of those works for you.

---

<div class="post-metadata">

**Author:** ![teklu](https://avatars.discourse-cdn.com/v4/letter/t/51bf81/32.png) [@teklu](https://discuss.openedx.org/u/teklu)\
**Post date:** [May 13, 2025, 8:47am UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/3 "2025-05-13T08:47:21Z")

</div>

Hi @Braden,  
thanks for your response,

I will check both options and let you know,

for your information, what i was doing to customize the authn mfe, first i stopped all mfe with

> tutor dev stop mfe

and then run what i have cloned with

> npm run dev

then that works as intended, but once i have registered or login, it will redirect to ‘/learner-dashboard’, and that mfe wasn’t running since i have stopped the entire mfe.

I will check what you suggested and let you know.

thank you again.

---

<div class="post-metadata">

**Author:** ![braden](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/braden/32/46_2.png) [@braden](https://discuss.openedx.org/u/braden)\
**Post date:** [May 13, 2025, 6:36pm UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/4 "2025-05-13T18:36:04Z")

</div>

Yes, if you add an MFE like `authn` to your tutor mounts, then when you run `tutor dev start mfe` it will run all MFEs _except_ `authn`, and you can decide when/how to run authn, either by using `npm run dev` on your host or `tutor dev start authn` to run it (bind mounted) inside a docker container.

---

<div class="post-metadata">

**Author:** ![teklu](https://avatars.discourse-cdn.com/v4/letter/t/51bf81/32.png) [@teklu](https://discuss.openedx.org/u/teklu)\
**Post date:** [May 15, 2025, 6:24am UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/5 "2025-05-15T06:24:53Z")

</div>

Hi @braden  
Thank you so much, that solves my problem.

---

<div class="post-metadata">

**Author:** ![wowothk](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.openedx.org/wowothk/32/8277_2.png) [@wowothk](https://discuss.openedx.org/u/wowothk)\
**Post date:** [May 23, 2025, 11:29am UTC](https://discuss.openedx.org/t/how-to-use-a-customized-mfe/15782/6 "2025-05-23T11:29:05Z")

</div>

Thank you guys. It also works for me. Anyway if i want to change the indigo logo, where are the MFE repository?
