---
schema_version: "1"
id: 1e95199510f8560a603b219705746730a0b5056e9b80d58cc3dd669c43fdae68
title: Deploying Mule Apps to Runtime Fabric Using Runtime Manager
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-fabric/2.7/deploy-to-runtime-fabric.md
canonical_url: https://docs.mulesoft.com/runtime-fabric/2.7/deploy-to-runtime-fabric
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 68caff8e36bd798a286dba9095c8118d6fa7b34cdde05d549724252fffd77ad3
description: MuleSoft Documentation Site
release: "2.7"
latest: false
---
---
product: Runtime Fabric
version: 2.7
---

# Deploying Mule Apps to Runtime Fabric Using Runtime Manager

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

You deploy Mule applications to Mule runtime servers on Anypoint Runtime Fabric.

Applications deployed to a production environment must be deployed to an instance of Runtime Fabric
that is separate from non-production applications.

After deploying an application you can test the inbound traffic for deployed applications.

## Deploy a Mule Application to Runtime Fabric

The full deployment process includes these steps:

1.  Select the application and deployment target

2.  Configure the deployment target

3.  Configure a public endpoint for the application

4.  Set up replication

5.  (Optional) Enable TLSv1 and TLSv1.1

6.  Configure application properties

7.  Deploy the application

Watch the following video to see how to deploy a Mule application to Runtime Fabric using Runtime
Manager:

![](https://play.vidyard.com/CoePGwoZgbY8AZWQxGZQKA.jpg)

### Prerequisites

Before deploying an application to Anypoint Runtime Fabric, perform the following:

- Review the [Anypoint Platform Roles and Permissions](https://docs.mulesoft.com/runtime-fabric/2.7/#anypoint-platform-roles-and-permissions)
  necessary for deploying applications to Runtime Fabric.

- Ensure that Runtime Fabric is associated with an environment. Refer to
  [Associating Business Groups and Environments to Anypoint Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/associate-environments)

- Determine the resource allocation requirements for your application. Refer to
  [Determine Application Resource Allocation on Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/deploy-resource-allocation-self-managed)
  for more information.

- To deploy an application to a specific domain (endpoint), ensure that you have set up domains
  (endpoints) in your environment. Refer to
  [Configure Ingress For Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/custom-ingress-configuration).

- If you’re using Runtime Fabric on Red Hat OpenShift, follow the steps in
  [Prepare for Deploying Mule Apps to Red Hat OpenShift](https://docs.mulesoft.com/runtime-fabric/2.7/install-openshift#prepare-for-deploying-mule-apps-to-red-hat-openshift)
  to enable app deployment.

### Select the Application and Deployment Target

1.  Sign into [Anypoint Platform](https://anypoint.mulesoft.com).

2.  Navigate to **Runtime Manager**, and select **Applications**.

3.  Click **Deploy application**.

4.  Provide a name for your application in the **Application Name** field.

    The name can contain only lowercase alphanumeric characters, hyphens, and underscores.

5.  Click **Choose File** to select the application to deploy, and then select one of the following
    options:

    - **Import file from Exchange**: Select a Mule application stored in Anypoint Exchange.

    - **Upload file**: Select a Mule application file from your filesystem.

6.  From the **Deployment Target** drop-down list, select the name of your Runtime Fabric.

7.  Select the Mule runtime engine version from the **Runtime Version** drop-down list.

    ![Runtime Manager UI with Mule Edge release dropdown window](/mulesoft/current/en-us/runtime-fabric/2.7/_images/rtf-rtm-mule-cadence.png)

The **Deployment Target**, **Ingress**, **Properties**, **Logs**, and **JVM** tabs are displayed.
Use these tabs to enter additional configuration information for your application.

To learn more about Mule runtime versions supported by Runtime Fabric, refer to
[Anypoint Runtime Fabric Patch Update Release Notes](https://docs.mulesoft.com/release-notes/runtime-fabric/runtime-fabric-runtimes-release-notes).

You can deploy Mule apps with Mule runtime engine versions that are within the standard support or
extended support life. Specify the versions through the API or in the Runtime Manager UI. With a
Mule runtime engine version in EOL (end of life) support, you can redeploy and restart Mule apps but
can not deploy new Mule apps.

### Configure a Public Endpoint for the Application

Use the following steps to configure a public endpoint for an application deployed to Runtime
Fabric.

Available domains and paths for an application come from the ingress resource template configured by
your Runtime Fabric administrator. Refer to
[Use Custom Ingress Resource Templates in Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/custom-ingress-configuration) for more
information.

> [!NOTE] If you do not select a domain, the application is deployed to an empty domain.

1.  Select **Ingress**.

2.  From the **Host** drop-down list, select a host for the application.

3.  If the hostname uses a wildcard, add a subdomain in the **Subdomain** field.

    The **Subdomain** field is only available if the hostname uses a wildcard.

4.  In the **Path** field, add a URL path to the application’s endpoint:

    ![A host and path are set for the application’s endpoint](/mulesoft/current/en-us/runtime-fabric/2.7/_images/rtf-ingress-endpoint.png)

5.  To preview the endpoint, click the generated preview link.

6.  To add additional endpoints, click **\+ Add Endpoint**.

### Set Up Replication and Storage

After you configure an application’s endpoints, set up replication to configure the number of
application instances to deploy.

A minimum of two replicas is required for high availability.

You set up object to storage to enable data persistence across Mule application replicas and
restarts. This option is only available on Mule runtime engine version 4.2.1 or later. If this
option is unavailable, contact your IT administrator. Refer to
[Persistence Gateway](https://docs.mulesoft.com/runtime-fabric/2.7/persistence-gateway) for more information.

1.  Select the **Deployment Target** tab.

    This tab displays the name and type of the deployment target previously selected.

2.  Select the number of replicas, or instances, of the application to deploy.

3.  To enable Mule clustering across each replica of the application, enable **Run in Runtime
    Clustering Mode**.

4.  To enforce the deployment of replicas across different nodes, select **Enforce deploying
    replicas across nodes**.

    > [!WARNING] If there is an insufficient number of worker nodes or resources available on the
    > worker nodes needed to deploy each replica, some replicas in the deployment remain in
    > **Pending** status. The deployment status transitions to **Running** after all replicas are
    > deployed on different worker nodes.

5.  To enable data persistence, select **Use Persistent Object Storage**.

6.  Specify the number of **Cores** and amount of **Memory** to allocate to each replica of the
    application by adjusting the sliders to the appropriate values.

    If needed, review [determine resource allocation](https://docs.mulesoft.com/runtime-fabric/2.7/deploy-resource-allocation-self-managed) for
    applications deployed to Runtime Fabric.

### (Optional) Enable TLS v1 and TLS v1.1

Starting with the
[August 3, 2021 patch releases](https://docs.mulesoft.com/release-notes/runtime-fabric/runtime-fabric-runtimes-release-notes#august-3-2021),
Mule runtime disables TLS v1 and TLS v1.1 by default for all runtime versions. When you deploy an
application to Runtime Fabric, you can enable TLS v1 or TLS v1.1 using JVM args.

1.  Click the **JVM** tab.

2.  In the **Java Virtual Machine arguments** field, add one of the following arguments:

    - Enable TLSv1.0 and TLSv1.1: `-Drtf.allow.TLSv1.0+`

    - Enable TLSv1.1: `-Drtf.allow.TLSv1.1`

### Configure Application Properties

> [!NOTE] For instructions on protecting application property values, see
> [Protect Application Property Values in Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/protect-app-properties)

Use Runtime Manager to configure any application property values, such as specifying the environment
or setting passwords and usernames.

Runtime Fabric resolves the property at runtime without exposing the sensitive information.

1.  Click the **Properties** tab.

2.  Click **Table view**.

3.  In the **New Key** field, add a property to protect.

4.  In the **New Value** field, add a value.

5.  Add additional properties as needed.

### Configure Logging and Log Levels

Anypoint Monitoring provides access to log data for applications deployed to Runtime Fabric. To
access logs with Anypoint Monitoring, you need a
[Titanium subscription](https://www.mulesoft.com/anypoint-pricing).

Anypoint Monitoring provides access to [log data](https://docs.mulesoft.com/monitoring/logs) for applications deployed
to Runtime Fabric. To access logs with Anypoint Monitoring, you need the Anypoint Integration
Advanced package or a Titanium subscription to Anypoint Platform.

1.  Click the **Logging** tab.

2.  Select the **Enable application logs** option.

3.  Select the log level from the drop-down list:

    - **INFO**: Informative messages

    - **DEBUG**: Debugging messages

    - **WARNING**: Warning messages

    - **ERROR**: Error messages, such as when an exception occurs

    - **FATAL**: Fatal messages for when an application fails

4.  Optionally, set the log level for specific a Java package class by selecting the log level,
    entering the `package.name`, and pressing the Enter key.

5.  Click **Apply Changes**.

### Deploy the Application

Now you’re ready to deploy the application.

1.  To deploy the application, click **Deploy Application**.

    If the **Deploy Application** button is disabled, ensure that you have uploaded a valid Mule
    application file. Also ensure that the Mule runtime engine version you selected is the same as
    the version used by your application.

_Result_: Runtime Manager displays a status message confirming the application deployment. After the
deployment starts, you’ll be directed to the applications list page where you can view the
deployment status.

For newly deployed applications, the status initially displays as **Starting**. The status updates
to **Started** if the application is successful. Monitor the application status to ensure that it
starts successfully.

## Verify Inbound Traffic for Deployed Applications

To test inbound traffic for deployed applications, you can send a request using the controller IP
address along with a host header set to the domain. The host header depends on the structure of the
application URL.

1.  Determine which endpoint exposes the application. The **Application url** field on the **Manage
    application** page in Runtime Manager contains this information.

2.  Run the following cURL command for verification:

    ```copy
    curl -Lvk -XGET {application-path-from-runtime-manager} --resolve {hostname}:443:{ip-address-of-controller}
    ```

    In the following example, `{application-path-from-runtime-manager}` is set to
    `[https://newapp.example-rtf.dev](https://newapp.example-rtf.dev)`, and `192.168.64.14` is the
    IP address of a controller machine in your cluster.

    ```copy
    curl -Lvk https://newapp.example-rtf.dev/ --resolve newapp.example-rtf.dev:443:192.168.64.14
    ```

## Configure Continuous Deployment

To set up a workflow for on-premises application deployment on Runtime Fabric, refer to
[Workflow for On-Premises Runtime Fabric](https://docs.mulesoft.com/runtime-manager/continuous-deployment#workflow-for-on-premises-runtime-fabric.adoc).

## Common Issues

When deploying applications, you may encounter the following issues:

- If your application remains in the **Starting** status for several minutes, this may be due to
  specifying a lower amount of resources. It’s common for applications to take several minutes to
  start up when selecting 0.3 cores or lower.

- If the application encounters an error during startup, the deployment stops and the status updates
  to **Failed**. An error message preview is displayed when clicking on the application and viewing
  the right sidebar. To view the entire message, click on the **Manage Application** button.

- An error message indicating `insufficient resources` is returned when Runtime Fabric doesn’t have
  the CPU cores or memory available for the deployment. When selecting multiple replicas, it’s
  important to know that the cores and memory specified applies to _each_ replica.

- If a re-deployment to an existing running application fails, the previous application remains
  running and active. This behavior enables zero-downtime application re-deployments. Runtime
  Manager reports the details and status of the failed deployment to help resolve the failure.

## See Also

- [Determine Application Resource Allocation on Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/deploy-resource-allocation-self-managed)

- [Deploy a Mule Application to CloudHub](https://docs.mulesoft.com/cloudhub/developing-applications-for-cloudhub)

- [Deploy a Mule Application to a Hybrid Environment](https://docs.mulesoft.com/runtime-manager/deploying-to-your-own-servers)