Mule 4.12 Edge leaves standard support this month. Upgrade to 4.13 before CloudHub does it for you
Mule 4.12 Edge reaches end of standard support in November 2026, and CloudHub moves Edge apps to the latest Edge version six weeks later. Upgrade to 4.13 yourself in that window, test the behaviour changes first, and don't plan on dropping back to 4.9 LTS.
part 28 of 28 · Platform releases, explained from scratchthe ideaChoose your own upgrade date before CloudHub does
after reading, you can- Work out which Mule apps CloudHub will move off 4.12 Edge, and roughly when
- Spot the 4.13 changes in error handling and caching that need testing before the move
- Plan a self-upgrade with a working rollback, and know why 4.9 LTS isn't an option
Mule 4.12 Edge leaves standard support this month. On CloudHub and CloudHub 2.0, MuleSoft will move every app still on it to the newest Edge version six weeks later, whether you've tested it or not. Upgrade your 4.12 apps to 4.13 yourself in the window, on a date you pick, and check the few 4.13 behaviour changes before you do.
Your Mule 4.12 apps are about to get a new runtime, on MuleSoft's schedule unless you set your own
MuleSoft is the integration platform many companies use to connect systems like Salesforce, SAP and their own databases. The small programs that do the connecting run on an engine called the Mule runtime. Version 4.12 came out in June 2026 on the fast-moving Edge channel, and its standard support ends in November 2026. If those apps run in MuleSoft's cloud, they get moved to the next Edge version automatically six weeks later. That's fine if someone tested them first. If nobody did, the upgrade happens over a weekend and the first person to notice might be a customer.
It's like a lease on a company car that the dealer swaps for the new model on a set date. You can book the swap yourself and drive the new one around the block first, or wait and find it in your parking space one morning with the seats moved.
- Teams with Mule apps on 4.12 Edge
- CloudHub and CloudHub 2.0 customers
- Runtime Fabric and on-prem Mule admins
- Owners of systems fed by Mule APIs
Why it matters to you
Nothing stops working on the day standard support ends. What changes is who decides when your apps move. On CloudHub and CloudHub 2.0, MuleSoft applies the Edge upgrade during a monthly patch window, so the change lands on its calendar, not yours. If an integration behaves differently on 4.13, you find out in production during that window.
There's a second catch for anyone who planned to escape to the long-term support channel. MuleSoft only supports switching from Edge to a later LTSdefinitionLong-term support. These Mule versions get at least 18 months of standard support, and nobody upgrades your apps to a new minor version behind your back. version, and the newest LTS is still 4.9. Moving a 4.12 Edge app back to 4.9 LTS isn't a supported path, so for most teams the real choice is between upgrading to 4.13 yourself or letting the auto-upgrade do it.
Runtime Fabric and on-premises (hybrid standalone) estates aren't auto-upgraded, so nothing changes on its own there. They still drop to extended support in November and after February 2027 they get no more patches, only limited end-of-life technical help. An app nobody upgrades just keeps running on an old, unpatched runtime.
-
01 Standard support ends
In November 2026, Mule 4.12 Edge moves to extended support. New CloudHub deployments go to versions still in standard support.
-
02 Self-upgrade window opens
For six weeks you can move each app to 4.13 Edge yourself, test it and roll back if you need to.
-
03 November patching is manual
MuleSoft paused automated patching this November, so even the 4.12.6 patch only reaches apps you redeploy.
-
04 Auto-upgrade runs
Six weeks after standard support ends, CloudHub moves whatever's still on 4.12 Edge to the latest Edge version. Nobody asks you first.
-
05 Extended support ends
Once extended support runs out after February 2027, CloudHub force-upgrades anything left on an end-of-life runtime in its monthly window.
For engineers: the auto-upgrade only moves the minor version. Monthly auto-patching inside a minor version (4.12.5 to 4.12.6, say) is a separate process, and in November 2026 MuleSoft runs it as self-upgrade only for CloudHub and CloudHub 2.0. CloudHub also won't auto-upgrade an app when the target version is incompatible with its configuration, such as a TLS or Java change. Both 4.12 and 4.13 run on Java 17, so that safety net doesn't apply here.
What changes when you go from 4.12 to 4.13
The 4.13 changes worth testing before you switch
The Cache scope now keeps only the payload and attributes instead of the whole Mule event. Old entries get converted the next time they're read. Apps with minMuleVersion below 4.13 keep the old behaviour.
Key Generator, Response Generator and Event Copy Strategy are deprecated. Set minMuleVersion to 4.13 with any of them configured and the deployment fails.
An error remapped inside a scope now keeps that type as it propagates out, instead of reverting to the raw connector error. Set mule.honourErrorMappingsOnErrorPropagation to false to go back.
JSON schema validation moved from the everit library to networknt, with everit kept as a fallback. Edge-case schemas can validate differently.
Header values containing carriage returns or line feeds are now sanitized. Before, the request was rejected.
A feature flag on by default since 4.13.0 means only allowlisted classes can be serialized with Kryo. Apps that serialize custom classes need testing.
Mule-generated keys now use dot notation and a mule.anypoint. prefix. The old keys still go out alongside, but they're deprecated.
DataWeave 2.13 adds modules to sign JSON Web Tokens with HMAC (HS256 to HS512) or RSA (RS256 to RS512) keys.
Most apps will move from 4.12 to 4.13 with nothing more than a regression run, because both are on Java 17 and a minor version keeps backward compatibility. The changes above are the ones that can still bite. Error handling is the one we'd test first: an on-error block that matched the raw connector error type might now see a remapped type instead, and the flow takes a different path.
Mule uses feature flags tied to each app's minMuleVersion setting in mule-artifact.json. Leave that value at 4.12 and a few 4.13 changes stay off for the app: the new Cache scope format, the Kryo allowlist and the per-flow OpenTelemetry counters. It doesn't stop the error-mapping, JSON schema, header or OpenTelemetry key-name changes, so test those whatever value you set. Raise it later, app by app, once you've tested what changes.
Watch the other direction too. The runtime refuses to deploy an app whose minMuleVersiondefinitionThe line in mule-artifact.json that says which runtime an app needs at minimum. Mule also reads it to decide which newer behaviours that app gets. is later than the runtime itself. Once an app says 4.13.0, rolling it back onto 4.12 fails. Keep the old build artifact if rollback is part of your plan, and know that 4.12 can't read cache entries written in the new format.
| Version | Released | Java | Standard support ends | Extended support ends |
|---|---|---|---|---|
| 4.11 Edge | Feb 2026 | 17 | Jul 2026 | Oct 2026 |
| 4.12 Edge | Jun 2026 | 17 | Nov 2026 | Feb 2027 |
| 4.13 Edge | Oct 2026 | 17 | Mar 2027 | Jun 2027 |
| 4.9 LTS | Feb 2025 | 17 | Aug 2027 | Feb 2028 |
| 4.6 LTS | Feb 2024 | 8, 11 and 17 | Aug 2026 | Feb 2027 |
The 4.12 Edge countdown
- Jun 2026Mule 4.12 Edge released
The second Edge release of 2026, on Java 17.
- 6 Oct 2026Mule 4.13.0 Edge released
This is where your 4.12 apps end up. Once it was out, 4.12 had about a month of standard support left.
- 3 Nov 2026November patches out
4.12.6 and 4.13.2 are available. On CloudHub this month they only reach apps you redeploy.
- Nov 20264.12 standard support ends
The six-week self-upgrade window starts.
- +6 weeksCloudHub auto-upgrade
Apps still on 4.12 Edge move to the latest Edge minor version during that month's patch window.
- Feb 20274.12 extended support ends
Runtime Fabric and on-prem apps still on 4.12 stop getting patches. Only limited end-of-life help is left.
- Mar 20274.13 standard support ends
Then you're back here again. Put the next upgrade in the calendar now, or CloudHub will pick that date for you too.
Read the table one way and the Edge channeldefinitionMuleSoft's fast track for the Mule runtime. You get up to three new versions a year and short support on each, and CloudHub upgrades these apps for you whether you're ready or not. looks like hard work: 4.13 gives you about five months of standard support before the same thing happens again. Edge versions from 4.9 onward get standard support until one month after the next Edge release, then three months of extended support. If your team can't retest every few months, that's an argument for a later LTS once one exists.
Your options, side by side
| Option | Who picks the date | Effort | Main risk |
|---|---|---|---|
| Self-upgrade to 4.13 Edge now | You | A regression run per app, plus checks on the changes listed above | Low, if you test error handling and caching first |
| Let CloudHub auto-upgrade | MuleSoft's patch window | None up front | Untested behaviour changes reach production in a weekend window |
| Move to 4.9 LTS | Not available | Unsupported | MuleSoft doesn't support Edge to older LTS moves |
| Stay on 4.12 (Runtime Fabric or on-prem) | You | None now, a bigger jump later | Extended support only, then no patches after February 2027 |
- Nobody lists which apps are on 4.12 Edge
- The November patch never arrives because nobody redeploys
- CloudHub moves the apps over a weekend while nobody's on call
- One error handler catches the wrong thing and orders stop flowing
- Support finds out from a business user on Monday
- Every 4.12 Edge app is on a list with an owner
- Apps go to 4.13 in sandbox first, with minMuleVersion left at 4.12
- Someone tests the error handlers and cached lookups before go-live
- Production moves midweek, and the team watches error rates as it goes
- Rollback to the previous version is ready and nobody needs it
Find every app on 4.12 before CloudHub does
Build the 4.12 Edge inventory
- 01List apps by runtime version
In Runtime Manager, open Applications in each environment and note every app on a 4.12 runtime. On CloudHub 2.0 the version tag ends in e for Edge, for example 4.12.6:7e.
- 02Check the deployment model
Mark each app as CloudHub, CloudHub 2.0, Runtime Fabric or hybrid standalone. Only the first two get the auto-upgrade, so they go to the top of the list.
- 03Read each app's minMuleVersion
Open mule-artifact.json in source control. Note which apps already declare a value above 4.12, because they have no easy rollback path.
- 04Search for the risky features
Grep the projects for cache scopes with a keyGenerator, responseGenerator or eventCopyStrategy, for custom error mappings, and for JSON schema validation. Those apps need the longest tests.
- 05Check replicas and deployment model
On CloudHub 2.0, an app with one replica or the Recreate deployment model has slight downtime during upgrades. Schedule those for a quiet window.
- 06Give every app an owner
Write down who signs off each app after the upgrade. An app nobody owns is the one the auto-upgrade will catch.
What to do now, by role
Who does what before the auto-upgrade window
- Ask your integration lead how many Mule apps run on 4.12 Edge, and which business processes they carry.
- Agree a test and upgrade date for each critical integration, before the holiday freeze if you have one.
- If a partner runs MuleSoft for you, ask them for the upgrade plan and the rollback plan in writing.
- Build the 4.12 Edge inventory from Runtime Manager and source control.
- Upgrade one low-risk app to 4.13 in sandbox with minMuleVersion left at 4.12, and run its MUnit tests.
- Test error handlers, cache scopes and JSON schema validation on the apps that use them.
- Redeploy apps you're not upgrading yet so they pick up the November patch.
- Move production apps to 4.13 inside the self-upgrade window, on weekdays, with monitoring dashboards open.
- Give single-replica CloudHub 2.0 apps a second replica or a quiet slot so the restart doesn't drop traffic.
- Book the Runtime Fabric and on-prem upgrades before February 2027. On standalone servers, the Mule Upgrade Tool does it one node at a time.
- Check that CI/CD deploys with a connected app scoped to the environments it needs, not a person's login.
- Use the new keyStoreInventory and healthSignals troubleshooting outputs to find expiring certificates.
- Review OAuth client credentials in connector configs while each app is open for testing.
Make the next Edge upgrade boring
Edge releases come up to three times a year, so this comes round again soon. The teams that cope treat the runtime upgrade as a routine change with a script, so nobody has to remember how it went last time.
Today: runtime upgrades happen to you
Apps deploy from a developer's machine with a personal login, tests are patchy, and the runtime version changes when MuleSoft's patch window says so.
After: upgrades go through the pipeline
A connected app with narrow scopes deploys from CI/CD, MUnit runs against the new runtime in sandbox first, and production moves inside the self-upgrade window.
Durable fixes, each tied to this upgrade
- 01Deploy from a pipeline
The Mule Maven plugin deploys to CloudHub, CloudHub 2.0, Runtime Fabric and on-prem servers. Change the runtime version in the pipeline config and every environment follows the same path.
- 02Use a connected app for deployments
Connected apps sign in with OAuth 2.0, get only the permissions you grant, are audited, and can be revoked at any time. That beats a person's admin login sitting in a build server.
- 03Grow MUnit coverage on the risky flows
Write tests for error handlers and cached lookups first. Those are where 4.13 behaves differently, and where the next Edge release may change things again.
- 04Run two replicas for anything customer-facing
CloudHub 2.0 restarts apps onto new hosts during upgrades. With one replica or the Recreate model there's a short outage each time.
- 05Put the Edge dates in the change calendar
You'll be doing this again soon, because 4.13 loses standard support in March 2027. Book that upgrade now and it won't catch you out.
If it goes wrong
If an app breaks after the move to 4.13, roll back first and debug second
Runtime Manager keeps the previous configuration, so the fastest fix is usually going back to 4.12 while you work out what changed. That works as long as minMuleVersion still allows it, and you clear the cache store first if the app caches.
- 01Containfirst hour
- In Runtime Manager, open the app's Settings and roll back to the previous runtime version, or redeploy the last good configuration.
- If the app ran a Cache scope on 4.13 with the new message-only format, clear that caching strategy's object store first. 4.12 can't read the new entries.
- If the app declares minMuleVersion 4.13.0, redeploy the previous build artifact as well, or the 4.12 runtime refuses it.
- 02Find the causefirst day
- Compare error types in the logs before and after. A different type in an on-error block points at the error-mapping change.
- Look at cache hit rates on the flows that cache. Check whether JSON schema validation started passing or failing messages it didn't before.
- Run the troubleshooting plugin operations to see logging, connection and certificate state on the new runtime.
- 03Fix and retestfirst week
- Adjust the error handler, or set mule.honourErrorMappingsOnErrorPropagation to false while you rework it.
- Replace deprecated cache customizations before raising minMuleVersion.
- Retest in sandbox, then promote to production inside the self-upgrade window.
- 04Catch up on datafirst week
- List messages that failed or went to a dead-letter queue during the bad run, and replay them once the fix is live.
- Tell whoever owns the downstream systems which records might be late or missing, so they're not surprised by the replay.
- 05Learnafter the fix
- Add a test for whatever broke, so the next Edge upgrade catches it in sandbox.
- Write the fix into the upgrade runbook with the app name and the setting changed.
What this looks like in practice
We made these three up to show common setups. None of them is a real customer, but you'll probably recognise one.
Three Mule setups, and how the 4.12 deadline hits each one
- the setup
- A retailer runs eight Mule apps on CloudHub 2.0, all on 4.12 Edge. Two sync orders to the warehouse system. Nobody has looked at runtime versions since go-live.
- what happens
- Nothing breaks this month. Six weeks after standard support ends, CloudHub moves all eight apps to the latest Edge version in a weekend patch window, with nobody watching.
- what to do
- Upgrade the six simple apps to 4.13 in sandbox this week, then in production. Test the two order flows with their error handlers before moving them.
- the setup
- An insurer's architects decided to leave Edge after the last auto-upgrade, and planned to redeploy 30 apps from 4.12 Edge onto 4.9 LTS.
- what happens
- MuleSoft doesn't support moving an app from Edge to an older LTS version. The plan stalls, the window runs down, and the apps sit on 4.12 heading for the auto-upgrade.
- what to do
- Move the apps to 4.13 Edge now and keep minMuleVersion at 4.12. Then plan the LTS move for when a release later than 4.13 appears.
- the setup
- A manufacturer runs Mule on Runtime Fabric in its own data centre and on two standalone servers near the plants. Both clusters are on 4.12.
- what happens
- No auto-upgrade arrives, so the deadline passes quietly. The runtime sits in extended support until February 2027, then runs with no patches at all.
- what to do
- Plan the upgrade before February. Use the Mule Upgrade Tool on the standalone servers, node by node, and redeploy Runtime Fabric apps on 4.13 after sandbox tests.
How Cohash helps
We build and run MuleSoft integrations on Anypoint Platform and move apps between runtime versions and channels. For the 4.12 deadline we can build the inventory, test the risky flows on 4.13 and run the production moves inside the window. See our MuleSoft services, hire MuleSoft engineers for your own team, or start with an assessment of your integration estate. Our API integration practice covers the wider design and governance work.
What to take from this
- 01
Mule 4.12 Edge leaves standard support in November 2026. CloudHub moves Edge apps still on it to the latest Edge minor version six weeks later.
- 02
Use the six-week window to upgrade to 4.13 yourself, in sandbox first, on a date your team picks.
- 03
You can't move a 4.12 Edge app back to 4.9 LTS. MuleSoft only supports Edge to a later LTS.
- 04
Test error handling, cache scopes and JSON schema validation first. Leaving minMuleVersion at 4.12 keeps some 4.13 behaviours off, but not the error-mapping change.
- 05
November's patches only reach apps you redeploy. Runtime Fabric and on-prem apps need a plan before February 2027.
01When does Mule 4.12 Edge support end?
Standard support ends in November 2026 and extended support ends in February 2027. MuleSoft's cadence table gives the month, not a day. On CloudHub and CloudHub 2.0 the bigger date is six weeks after standard support ends, when Edge apps still on 4.12 get auto-upgraded.
02Will CloudHub upgrade my 4.12 apps automatically?
Yes, if they're on the Edge channel in CloudHub or CloudHub 2.0. MuleSoft moves them to the latest Edge minor version six weeks after standard support ends, during that month's patch window. Runtime Fabric and hybrid standalone apps aren't auto-upgraded.
03Can I move my 4.12 Edge apps to 4.9 LTS instead?
No. MuleSoft lets you go from Edge to a later LTS, and 4.9 is older than 4.12. Until a newer LTS comes out, keeping up with Edge releases is the only supported route, annoying as that is.
04Is upgrading from Mule 4.12 to 4.13 hard?
Usually not. Both run on Java 17 and minor versions keep backward compatibility. Test error handling, cache scopes with custom Java, JSON schema validation and Kryo serialization of custom classes, because 4.13 changes behaviour there.
05Why didn't our CloudHub apps get the November patch?
MuleSoft paused automatic patching on CloudHub and CloudHub 2.0 for the November cycle. The 4.12.6 and 4.13.2 patches, released on November 3, only reach apps you redeploy or upgrade yourself.
06How long will Mule 4.13 Edge be supported?
You get standard support until March 2027 and extended support until June 2027. That's a short run, so book the next Edge upgrade for early 2027, or move to a later LTS if MuleSoft releases one.
07Do Runtime Fabric apps on 4.12 need to do anything?
Not this month, since nothing moves them automatically. They drop to extended support in November 2026 and lose it after February 2027, so book the upgrade before then.
Three questions, about a minute
Pick an answer and we'll tell you if it's right, and why it is or isn't. The score stays in this browser.
-
Q1Your architect wants to move 4.12 Edge apps to 4.9 LTS to escape auto-upgrades. What do you tell them?
show the answer
B. MuleSoft doesn't support moving Edge apps to an older LTS You can go from Edge to a later LTS, never an older one, and 4.9 is older than 4.12. Move to 4.13 Edge for now and revisit LTS when a newer one comes out.
-
Q2After the move to 4.13, an on-error block stops catching a connector error it used to catch. What's the likeliest cause?
show the answer
D. Error mappings now keep their remapped type as they propagate 4.13 preserves an error's remapped type when it leaves a scope instead of reverting to the raw connector type. Adjust the handler, or set the system property to false while you rework it.
-
Q3An app declares minMuleVersion 4.13.0 and breaks on the 4.13 runtime. Why does rolling back to 4.12 fail?
show the answer
A. The runtime won't deploy an app whose minMuleVersion is later than the runtime Mule refuses to deploy an app that asks for a later runtime than the one it's on. Redeploy the old build artifact with minMuleVersion at 4.12 as part of the rollback.