---
schema_version: "1"
id: 529b900c1488908c07ac0e32212295cc1074c7aea317e162e161f6cf7a8dffa1
title: Deploy to Your Servers
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-manager/deploying-to-your-own-servers.md
canonical_url: https://docs.mulesoft.com/runtime-manager/deploying-to-your-own-servers
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7893e52ee219a1710c07af5dd52c1dc22f240bfac34b66ccba786a694a288403
description: MuleSoft Documentation Site
latest: true
---
---
product: Runtime Manager
keywords: cloudhub, cloud, deploy, manage, runtime manager, arm
---

# Deploy to Your Servers

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

[![logo hybrid active](/mulesoft/current/en-us/_/img/icons/hybrid-cloud.svg "Hybrid")Hybrid](deployment-strategies#hybrid-deployments)[ ![logo server active](/mulesoft/current/en-us/_/img/icons/server-cloud.svg "Anypoint Platform PCE")Private Cloud Edition](deployment-strategies#anypoint-platform-private-cloud-edition)

You can deploy a Mule application to a local server using:

- [Anypoint Platform Runtime Manager cloud console](https://docs.mulesoft.com/runtime-manager/deployment-strategies#cloudhub-deployments)

- [Anypoint Platform Private Cloud Edition Runtime Manager console](https://docs.mulesoft.com/runtime-manager/deployment-strategies#anypoint-platform-pce-deployments)

- [Runtime Manager API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

- [Mule Maven plugin](https://docs.mulesoft.com/mule-runtime/latest/deploy-on-premises)

When you use Runtime Manager to manage a server, you cannot use other deployment and management
methods or tools to manage it.

## Prerequisites

Before you can deploy to a local server, you must first:

1.  [Download and install Mule](https://docs.mulesoft.com/on-premises/latest/runtime-installation-task).

2.  [Add a server to Runtime Manager](https://docs.mulesoft.com/runtime-manager/servers-create).

To copy an application from a non-production (Sandbox) environment to a production environment,
ensure that you have permission on both environments.

To avoid compatibility issues, also ensure that:

- The Mule versions on the servers in both environments are the same or compatible.

- The deployment target type (single server, server group, or cluster) in both environments is the
  same.

- All servers in a server cluster are on the same Java version, and the target Java version matches
  that of the application. You can check the Java version associated to your target in **Anypoint
  Platform** > **Runtime Manager** > **Servers**.

## Deploy an Application from Runtime Manager

To deploy an app to your local server from Runtime Manager:

1.  Sign in to Anypoint Platform.

2.  Select **Runtime Manager**.

3.  In the **Applications** page, click **Deploy application**.

4.  Provide a name for your application.

    The application name identifies your application in Runtime Manager and must be unique across
    environments. Runtime Manager alerts you if the name is already in use.

    Application names can contain between 3 and 42 alphanumeric characters (a-z, A-Z, 0-9) and
    dashes (-). They cannot contain spaces or other characters.

    > [!IMPORTANT] You cannot change the name of an app after you deploy it. To change the name, you
    > must delete and redeploy the app using the new name.

5.  Select the deployment target.

    The target must be a running server, server group, or cluster.

6.  Specify the application file:

    - Import a file from Exchange:

      1.  Click **Choose file** and then select **Import file from Exchange**.

      2.  Select **Application** for the type.

      3.  Enter the name of your application in the search box.

      4.  Select the application to deploy, select a version from the **Version** menu, and then
          click **Select**.

    - Upload an application ZIP file:

      1.  Click **Choose file** and then select **Upload file**.

      2.  Select the file to upload and then click **Open**.

    - Copy an application from a non-production environment:

      1.  Click **Get from sandbox**.

          This button is available only if a non-production environment exists.

      2.  Select the environment, such as Sandbox, from which to get the application.

      3.  If necessary, search for the application to deploy.

      4.  Select the application and then click **Apply**.

          Only applications that are deployed to a local server, server group, or cluster appear in
          the list. Applications deployed to CloudHub can only be promoted to run on other CloudHub
          workers.

7.  Click tabs to configure application options:

    ![Configuration tabs on the Deploy Application page](/mulesoft/current/en-us/runtime-manager/_images/rtm-deploy-to-own-servers.png)

    Figure 1. The arrow shows the configuration tabs on the **Deploy Application** page.

    **Deployment Target** tab

    The server, server group, or cluster that you selected determines the Mule version.

    Ensure that this Mule version is the same version used to develop your application.

    **Insight** tab

    Specify metadata options for the Insight analytics feature. See [Insight](https://docs.mulesoft.com/runtime-manager/insight).

    **Properties** tab

    Specify properties (key-value pairs) that the application uses during deployment and while
    running.

    When you deploy an application from a non-production environment (**Get from sandbox**), the new
    application inherits any properties defined in the original application. You can update these
    properties as required on the **Properties** tab before deploying the application.

    See [Manage Properties for Applications On-Premises](https://docs.mulesoft.com/runtime-manager/hybrid-manage-props) and
    [Safely Hide Application Properties](https://docs.mulesoft.com/cloudhub/secure-application-properties).

    **Logging** tab

    Configure the logging level for the application: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, or
    `FATAL`.

    Alternatively, you can configure logging by modifying the `level` value in the `log4j2.xml`
    file. See
    [Configuring Custom Logging Settings](https://docs.mulesoft.com/mule-runtime/latest/logging-in-mule#configuring-custom-logging-settings)
    and [Apache Logging Services](https://logging.apache.org/log4j/2.x/manual/configuration.html).

    After you deploy the application, two additional tabs are available:

    **Flow Monitoring** tab

    Specify to make flow monitoring metadata available in the applications **Flows** page.

    **Alerts History** tab

    View alerts for the application.

8.  Click **Deploy Application**.

The new application appears in the list of deployed applications in the Applications tab.

## Change a Deployed Application

You can change the application file of a deployed application:

1.  Select your application in the **Applications** page to open its corresponding panel.

2.  Click **Choose File** to upload a new file.

Your application might experience a moment of downtime while the new version is launched in the
server, server group, or cluster.

## Deployment Errors

If an error occurs and the application cannot be deployed, the application status indicator changes
to `Failed` and the status area indicates that an error occurred. Check the log details for any
application deployment errors. Correct the error, upload the application, and redeploy the
application.

## See Also

- [Ports, IP Addresses, and Hostnames to Allow](https://docs.mulesoft.com/runtime-manager/rtm-agent-allowlists)

- [Manage Applications on Your Servers](https://docs.mulesoft.com/runtime-manager/managing-applications-on-your-own-servers)

- [Servers, Server Groups, and Clusters](https://docs.mulesoft.com/runtime-manager/managing-servers)

- [Monitor Applications and Servers](https://docs.mulesoft.com/runtime-manager/monitoring)

- [Runtime Manager REST APIs](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)
