Contact Us 1-800-596-4880
  1. Homepage
  2. Mule Runtime (4.1)
  3. Mule 4 for Mule 3 Users
  4. Migration to Mule 4

  5. Prepare to Migrate

Prepare to Migrate to Mule 4

Standard Support for Mule 4.1 ended on November 2, 2020, and this version of Mule reached its End of Life on November 2, 2022, when Extended Support ended.

Deployments of new applications to CloudHub that use this version of Mule are no longer allowed. Only in-place updates to applications are permitted.

MuleSoft recommends that you upgrade to the latest version of Mule 4 that is in Standard Support so that your applications run with the latest fixes and security enhancements.

Mule 4 introduces many changes, so plan accordingly before attempting to migrate from Mule 3.

When to Start Using Mule 4

MuleSoft recommends that you develop all new projects on Mule 4, provided that:

  • You and your team have updated your skills for Mule 4 through the documentation or formal training.

  • You have the proper deployment environment.

For projects deployed on Mule 3, use the Mule Migration Assistant (MMA) to avoid re-creating the application in Mule 4.

Migrate your applications if any one of the following conditions is met:

  • The 3.x version you are using reaches end of life.

  • You want to make significant updates to the existing applications.

  • You want to take advantage of key Mule 4 capabilities.

  • You decide to upgrade all your apps to Mule 4 because your organization requires all apps to be on one version (for some on-prem scenarios).

Setting up Your Local Development Environment

First, download and install Anypoint Studio 7. If the Mule version that comes with Anypoint Studio does not match the Mule version you want to use for local deployments, download the desired 4.x version of Mule runtime engine.

Getting Ready to Deploy

Next, you need to make sure your deployment environment is ready. Depending on which environment you have, different steps may be required.

Deployment Mechanism Instructions

CloudHub

CloudHub is Mule 4 ready.

Hybrid Deployment

Install Mule 4 on your servers.

Anypoint Runtime Fabric

Runtime Fabric supports Mule 4.

Anypoint Platform Private Cloud Edition (PCE)

PCE supports Mule 4.

Writing the Code

If you are performing a completely manual migration, you are ready to start building and deploying Mule 4 applications. Simply review Introduction to Mule 4 topics to get an overview of the migration process and understand changes introduced in Mule 4.

For guidance with an assisted migration using the Mule Migration Assistant (MMA), it is important to review the MMA documentation (on GitHub).

Important

Mule Migration Assistant (MMA) is subject to the terms and conditions described for Community connectors. Additionally, Mule Migration Assistant is distributed under the terms of the 3-Clause BSD License.