Contact Us 1-800-596-4880
  1. Homepage
  2. Mule Runtime (4.4)
  3. Run Mule Runtime Engine On-Premises

  4. Install an Enterprise License

Install an Enterprise License

MuleSoft makes available a trial version of the Enterprise Edition of Mule runtime engine (Mule) for the purpose of evaluation. Though perfect for exploring Mule and Anypoint Studio, the trial license for Enterprise limits usage of Mule and is not appropriate for production uses.

Complete the following steps to acquire and install a non-trial Enterprise license before you use Mule runtime in a production environment.

  1. Contact your MuleSoft account representative or the MuleSoft sales team to acquire an Enterprise license in the form of a license.lic file.

  2. Before installing, it’s recommended to remove the previous license from your $MULE_HOME directory:

    1. Navigate to $MULE_HOME/conf/

    2. Delete the existing muleLicenseKey.lic file.

  3. If you are installing your license on multiple platforms, back up your new license.lic file in another location before proceeding.

  4. Make sure that the Mule Server is stopped (not running) and then open the terminal or command line on your system.

  5. Set the JAVA_HOME environment variable before running the mule -installLicense command.

    1. On Mac/Unix/Linux, if JAVA_HOME isn’t detected automatically, set it to avoid any issues.

    2. On Windows, if JAVA_HOME isn’t set, the license installation fails.

  6. Run the license installation command:

    1. On Mac/Unix/Linux, from the $MULE_HOME/bin directory, run mule -installLicense ~/license.lic.

    2. On Windows, copy the license.lic file to the \bin folder, and then run mule.bat -installLicense license.lic from the command line.

  7. In the $MULE_HOME/conf directory, Mule saves a new file called muleLicenseKey.lic. This shows that the license has been installed.

  8. Start your Mule Server again, by the usual means.

Verify or Remove Enterprise Edition License

Make sure that the Mule Server is stopped and then open the terminal or command line on your system.

  • To verify that Mule successfully installed your Enterprise license, run the following command:

    mule -verifyLicense

    The command outputs:

    License information Evaluation = false, Expiration Date = Tue May 19 00:00:00 UTC 2025, Contact Name = John Doe, Contact Email Address = john.doe@company.com, Contact Telephone = 00000000, Contact Company = Local Global Ltd, Contact Country = US, Entitlements = clustering,api-gateway

  • To uninstall a previously installed license, run the following command:

    mule -unInstallLicense

    Sometimes the license installation fails and it might be necessary to manually delete $MULE_HOME/conf/muleLicenseKey.lic

  • To verify the license before installing it, run the following command:

    mule -verifyLicenseDetails [path_to_license]

    The command outputs the same information as in mule -verifyLicense.

Download your License Key File

  1. Log in to the Support portal using your login information. If you do not have credentials to log in, please contact your Customer Success Manager.

  2. Click on the Support tab located on the navigation menu of the Mulesoft Help Center home page.

  3. Click on the Subscriptions tab located halfway through the page.

  4. Click on the Subscription Name of the subscription you would like a license key for. Please note that you must click on the Subscription Name (second column on the right) or you will not be forwarded to the correct page.

  5. Click on the License ID number located at the end of the page on the right.

  6. Click on the License Key file located in the Notes & Attachments section at the beginning of the page on the right to download your license key.

Install Enterprise License on Embedded Mule

Though not recommended for production environments, you have the option of installing an Enterprise license on the Mule that comes bundled with Studio.

  1. Download and install Mule Enterprise Edition.

  2. Contact your account representative or the MuleSoft sales team to acquire an Enterprise Edition license in the form of a license.lic file.

  3. Complete the steps outlined above to install the new license on the Mule Enterprise Edition from the first step.

  4. From the $MULE_HOME/conf directory, copy the new license file that Mule stored: muleLicenseKey.lic.

  5. Paste the muleLicenseKey.lic file into the classpath of your embedded application in Mule bundled with Studio.

Install Product Licenses

To use the SAP Connector or other premium connectors, you must first acquire, then install a product license. Contact your account representative or the MuleSoft sales team to acquire a license for one of the above products.

The MuleSoft Enterprise Maven customer repository allows you to access Mule Enterprise modules, connectors, and other components not included in the trial or community versions. See About the Mule Maven Plugin for details.

See Also