---
schema_version: "1"
id: fbb5e7acb604c0a775b4d11b284fde3609f98b72386d58e06b109c1fd86ff0c9
title: Migration to Mule 4
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/mule-runtime/4.4/migration-intro.md
canonical_url: https://docs.mulesoft.com/mule-runtime/4.4/migration-intro
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 1a65b929b20ca99eef01a29be2da0bda28b5c22fbc312fe0882af1a01895fce5
description: MuleSoft Documentation Site
release: "4.4"
latest: false
---
---
product: Mule Runtime
version: 4.4
---

# Migration to Mule 4

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

For your Mule 3 apps to take advantage of Mule 4, migrate them to Mule 4 through one of the
following processes:

- A fully manual migration of connectors, modules, transports, expressions, and API gateways to
  their Mule 4 counterparts.

  For guidance with a fully manual migration, see [Prepare to Migrate](https://docs.mulesoft.com/mule-runtime/4.4/migration-prep) and review
  [Manual Migration Process](https://docs.mulesoft.com/mule-runtime/4.4/migration-process).

- A partially automated migration with the Mule Migration Assistant (MMA), which is available as an
  open source project on GitHub.

  For guidance using MMA to assist in a migration, see the
  [user documentation (on GitHub)](https://github.com/mulesoft/mule-migration-assistant/blob/master/docs/migration-intro.adoc#understand-the-mma-migration-process).
  MuleSoft suggests that you try MMA to determine whether you prefer it to a fully manual migration.
  Note that you can run MMA on a sample application by following steps in the
  [Migration Tutorial (on GitHub)](https://github.com/mulesoft/mule-migration-assistant/blob/master/docs/user-docs/migration-tutorial.adoc).

Important

**Mule Migration Assistant (MMA) is subject to the terms and conditions described for
[Community](https://www.salesforce.com/en-us/wp-content/uploads/sites/4/documents/legal/Agreements/versioning-back-support-policy.pdf)
connectors. Additionally, Mule Migration Assistant is distributed under the terms of the
[3-Clause BSD License](https://github.com/mulesoft/mule-migration-assistant/blob/master/LICENSE.txt).**

A benefit of using MMA is that it automates part of the migration of Mule 3 apps to Mule 4. Though
the MMA does not migrate the app entirely, it provides significant help with the following tasks:

- Migrating the project structure.

- Automatically creating descriptor files, such as `pom.xml` or `mule-artifact.json`.

- Automatically performing many adaptations of the app’s code.

- Providing guidance on how to manually migrate components and patterns that cannot be migrated
  automatically.

MMA helps with such tasks, but it does not deliver a fully functional app. Some additional steps are
required. Those steps include testing and can also include:

- Manual migration of unsupported components.

- Manual migration of complex MEL expressions to DataWeave that cannot be automatically converted by
  MMA.

- Manual migration of complex DataWeave transformations that cannot be automatically converted by
  MMA.

- Prior migration of the DataMapper with the DataWeave Migration tool, before running the MMA.

It is also important to note that the MMA does not support incremental migrations.