---
schema_version: "1"
id: 26a3fd160074c5a6fd2ac9a212c1528af523d0f1d68eb0ecda1edd58dcdca169
title: Manage Deployed Applications
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-manager/managing-deployed-applications.md
canonical_url: https://docs.mulesoft.com/runtime-manager/managing-deployed-applications
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7cca4d46091549c4bc156096062ff8e0be340137db4e0dbf17ea3b26f446dee2
description: MuleSoft Documentation Site
latest: true
---
---
product: Runtime Manager
---

# Manage Deployed Applications

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

[![logo cloudhub 2.0 active](/mulesoft/current/en-us/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/en-us/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)[ ![logo rtf active](/mulesoft/current/en-us/_/img/icons/cloud-gear.svg "Runtime Fabric")Runtime Fabric](deployment-strategies#anypoint-runtime-fabric-deployments)

After you deploy apps, use the Runtime Manager console to monitor and manage running applications.
The different management functionalities available depend on the
[deployment option](https://docs.mulesoft.com/runtime-manager/deployment-strategies) you use.

The basic management tools in the Runtime Manager console enable you to perform the following tasks:

- [Start, stop, and delete apps](#start_stop_delete_app)

- [View status states for apps](#status_states)

- [Update apps](#update_application)

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

For applications deployed to [your own servers](https://docs.mulesoft.com/runtime-manager/managing-applications-on-your-own-servers), you can
also:

- [Manage servers](https://docs.mulesoft.com/runtime-manager/managing-servers)

- [Create clusters and server groups](https://docs.mulesoft.com/runtime-manager/server-group-create)

- [Send data from Runtime Manager to external analytics software](https://docs.mulesoft.com/runtime-manager/sending-data-from-arm-to-external-analytics-software)

- [Manage individual flows](https://docs.mulesoft.com/runtime-manager/flow-management)

On applications deployed to [CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/ch2-manage-apps), you can also:

- [Configure Application Alerts](https://docs.mulesoft.com/cloudhub-2/ch2-config-app-alerts)

- [Manage Application Schedules](https://docs.mulesoft.com/cloudhub-2/ch2-manage-schedules)

- [Add Application Properties](https://docs.mulesoft.com/cloudhub-2/ch2-manage-props)

- [View Log Data for Deployed Applications](https://docs.mulesoft.com/cloudhub-2/ch2-view-logs)

- [View Diagnostic Data for Deployed Applications](https://docs.mulesoft.com/cloudhub-2/ch2-view-diag)

- [Enable Distributed Tracing](https://docs.mulesoft.com/cloudhub-2/ch2-deploy-private-space#enable-distributed-tracing)

- [Use Object Store v2](https://docs.mulesoft.com/cloudhub-2/ch2-clustering#cloudhub-2-0-clustering-and-object-store-v2)

On applications deployed to [CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub), you can also:

- [Manage notifications](https://docs.mulesoft.com/cloudhub/notifications-on-runtime-manager)

- [Use Insight to troubleshoot business transactions and events on your Mule apps](https://docs.mulesoft.com/runtime-manager/insight)

- [Manage queues](https://docs.mulesoft.com/cloudhub/managing-queues)

- [Manage schedules](https://docs.mulesoft.com/cloudhub/managing-schedules)

- [Safely hiding application properties](https://docs.mulesoft.com/cloudhub/secure-application-properties)

- [View application log data](https://docs.mulesoft.com/cloudhub/viewing-log-data)

- [Monitor CloudHub workers](https://docs.mulesoft.com/cloudhub/worker-monitoring)

- [Manage app data with object stores](https://docs.mulesoft.com/cloudhub/managing-application-data-with-object-stores)

On applications deployed to [Anypoint Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/), you can also:

- [Manage App Schedules](https://docs.mulesoft.com/runtime-fabric/latest/manage-schedules)

- [Protect Application Property Values](https://docs.mulesoft.com/runtime-fabric/latest/protect-app-properties)

- [Review Application Versioning](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)

## Applications Tab

In Runtime Manager, an "application" is a Mule application that is running on a Mule runtime engine
(Mule) or an API gateway runtime instance. The instance can be running in CloudHub, in an
on-premises server of your organization, in a group of servers, or in a server cluster.

In the **Applications** menu, you can get a quick view of the applications that are currently
deployed and running for your account. Click an entry to display additional information (as shown
here), or click **Manage Application** to see the application’s [dashboard](https://docs.mulesoft.com/runtime-manager/monitoring-dashboards)
and settings page:

![AMC\_ManageApplication](/mulesoft/current/en-us/runtime-manager/_images/amc-manageapplication.png)

After you create at least one application, you can see your applications listed here.

An application deployed to a server group runs on every server in the group.

## Servers Tab

This tab is used only to deploy apps to on-premises servers. CloudHub workers aren’t displayed here.

In Runtime Manager, a "server" is a Mule or API gateway instance in a location other than CloudHub
(on-premises or in a different cloud server) that you must first register in the Runtime Manager
console. After you register and configure your server, you can deploy your applications to it from
the **Applications** tab.

![AMC\_Servers](/mulesoft/current/en-us/runtime-manager/_images/amc-servers2.png)

From the **Servers** tab, select one of the following options to perform these tasks:

- Add a Server (registers the server with the Runtime Manager console)

- Start Mule or API gateway

- Create a server group

- Create a cluster

- Add and remove servers from a server group

- Add and remove servers from a cluster

- Stop an application on a server

- Delete a server, server group or cluster

For more about the options on this tab, see
[Servers, Server Groups, and Clusters](https://docs.mulesoft.com/runtime-manager/managing-servers).

## Switch Environments

If you have multiple environments in your organization, you can switch between them:

1.  From any screen in Runtime Manager, click the current environment, which is displayed in the
    upper left corner of the screen.

2.  Select the environment to switch to.

3.  Click **Switch**.

![managing deployed applications 0e10f](/mulesoft/current/en-us/runtime-manager/_images/managing-deployed-applications-0e10f.png)

## Start, Restart, Stop, or Delete an Application

1.  In **Applications**, click an application name to open its management panel on the right side of
    the screen.

2.  Next to the status, click the down-arrow (the menus differ according to the app’s current
    state):

    ![AMC\_StopStartDeleteApp](/mulesoft/current/en-us/runtime-manager/_images/amc-restartapp.png)

3.  Click the action to perform:

    - **Start**

      Starts stopped applications

    - **Restart**

      Resets applications that have already started. If the application is undeployed, the
      application’s ZIP file is sent to the server to start the application on the server.

    - **Stop**

      Stops running applications.

    - **Delete**

      Deletes the application.

If you’re deploying your application to an on-premises cluster, Runtime Manager starts/stops/deletes
the application simultaneously on each server.

> [!IMPORTANT] On CloudHub, after you delete an application, your log data is no longer accessible
> from the console. CloudHub archives old log data for a limited period of time before it is purged.
> This allows you to recover the data if needed. Open a support case at:
> [Salesforce Help](https://help.salesforce.com) for more information.

## Status States

The information in the **Status** column depends on the context:

- [Application Status States](#application_status_states)

- [Application Deployment States](#application_deploy_states)

- [Replica Status States](#replica_status_states)

- [Server Status States](#server_status_states)

- [Server Groups Status States](#server_groups_status_states)

- [Cluster Status States](#cluster_status_states)

### Application Status States

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Icon</th><th>State</th><th>Description</th></tr></thead><tbody><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b"></div></div></div></td><td><div><div><ul><li><p><strong>Stopped</strong></p></li><li><p><strong>Not Running</strong></p></li><li><p><strong>Undeployed</strong></p></li></ul></div></div></td><td><div><div><p>The application is not running.</p></div></div></td></tr><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-515a4.png" alt="managing deployed applications 515a4"></div></div></div></td><td><div><div><ul><li><p><strong>Starting</strong></p></li><li><p><strong>Stopping</strong></p></li><li><p><strong>Undeploying</strong></p></li></ul></div></div></td><td><div><div><p>Application is in the process of transitioning to another state.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/console-overview-green-circle.png" alt="console_overview_green_circle"></span></p></div></div></td><td><div><div><ul><li><p><strong>Started</strong></p></li><li><p><strong>Running</strong></p></li><li><p><strong>Updated</strong></p></li></ul></div></div></td><td><div><div><p>Application is running or the update succeeded.</p></div><div><p>The Application shows Started when running on at least one of the Cluster nodes.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/console-overview-red-circle.png" alt="console_overview_red_circle"></span></p></div></div></td><td><div><div><ul><li><p><strong>Deployment Failed</strong></p></li></ul></div></div></td><td><div><div><p>Application deployment failed.</p></div><div><p>The cause of the failure appears in the console.</p></div></div></td></tr><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-ab70d.png" alt="managing deployed applications ab70d"></div></div></div></td><td><div></div></td><td><div><div><p>Application update failed.</p></div></div></td></tr></tbody></table>

### Application Deployment States

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Icon</th><th>State</th><th>Description</th></tr></thead><tbody><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b"></div></div></div></td><td><div><div><p><strong>Deleted</strong></p></div></div></td><td><div><div><p>Application is deleted.</p></div></div></td></tr><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-515a4.png" alt="managing deployed applications 515a4"></div></div></div></td><td><div><div><p><strong>Applying</strong></p></div></div></td><td><div><div><p>Application is in the process of transitioning to another state.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/console-overview-green-circle.png" alt="console_overview_green_circle"></span></p></div></div></td><td><div><div><p><strong>Applied</strong></p></div></div></td><td><div><div><p>Application is running or the update succeeded.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/console-overview-red-circle.png" alt="console_overview_red_circle"></span></p></div></div></td><td><div><div><p><strong>Failed</strong></p></div></div></td><td><div><div><p>Application deployment failed.</p></div><div><p>The cause of the failure appears in the console.</p></div></div></td></tr><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-de1b7.png" alt="managing deployed applications de1b7"></div></div></div></td><td><div><div><p><strong>Unknown</strong></p></div></div></td><td><div><div><p>Application’s status is unknown because the server is not responding to the platform (on-premises deployments only).</p></div></div></td></tr></tbody></table>

### Replica Status States

Replica statuses apply only to applications deployed on Runtime Fabric. These statuses appear when
you are applying new, or changed, configurations to deployed applications. See
[Application Deployment Versioning](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning).

Replica statuses include:

- **Started** (green)

  Replica is receiving traffic.

- **Pending**

  Replica is waiting to start.

- **Starting**

  Process is starting on the replica.

- **Deleting**

  Replica deletion is in progress.

- **Deleted**

  Replica has been deleted.

- **Stopping**

  Replica is stopping.

- **Stopped**

  Replica is stopped (not receiving traffic).

- **Failed** (red)

  Configuration failed to deploy.

- **Recovering** (red)

  Replica is attempting to restart after terminating.

### Server Status States

- **Connected**

  Server is available for use.

- **Created**

  Server was recently registered into the system and has never been connected.

- **Running**

  Server is up and running, and accepting requests.

- **Disconnected**

  Server is currently unavailable but is registered and ready to connect.

### Server Groups Status States

- **Connected**

  All servers in the server group are connected.

- **Created**

  Server group created.

  This state occurs temporarily after creating a group until Empty asserts.

- **Disconnected**

  All servers in the server group are unavailable. This state can occur if the network goes down or
  one or more servers in a group fail.

- **Empty**

  No servers are currently assigned to this group.

- **Partial**

  One or more servers in the group have differing states.

- **Running**

  All servers in the server group are running.

### Cluster Status States

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Icon</th><th>State</th><th>Description</th></tr></thead><tbody><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/status-green.png" alt="green"></span></p></div></div></td><td><div><div><p>Running</p></div></div></td><td><div><div><p>All nodes are running.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/status-yellow.png" alt="yellow"></span></p></div></div></td><td><div><div><p>Running</p></div></div></td><td><div><div><p>At least one of the Cluster nodes is running.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/status-yellow.png" alt="yellow"></span></p></div></div></td><td><div><div><p>Running with communication issue</p></div></div></td><td><div><div><p>All nodes are running, but communication issues exist between them.</p></div></div></td></tr><tr><td><div><div><div><img src="https://docs.mulesoft.com/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b"></div></div></div></td><td><div><div><p>Disconnected</p></div></div></td><td><div><div><p>All nodes are disconnected.</p></div></div></td></tr><tr><td><div><div><p><span><img src="https://docs.mulesoft.com/runtime-manager/_images/status-black.png" alt="black"></span></p></div></div></td><td><div><div><p>Created</p></div></div></td><td><div><div><p>A server/node is registered in the platform but is not started.</p></div></div></td></tr></tbody></table>

## Applications Management Panel

If you select any of the applications on the **Applications** tab, a panel opens on the right. Here
you can see additional information about the application and access its settings.

![dashboard](/mulesoft/current/en-us/runtime-manager/_images/dashboard-ch.png)

What the management panel displays depends on whether your application is deployed on
[CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub) or on
[your servers](https://docs.mulesoft.com/runtime-manager/managing-applications-on-your-own-servers):

- Applications on CloudHub display information about the CloudHub worker on which they run.

- Applications deployed on clusters and server groups display the list of servers and the status of
  each.

You always see the status, the time of the last modification, and the deployed application ZIP file.
The **Choose File** button enables you to change the application ZIP file.

The **Manage Application** button enables you to view and configure several more application
settings:

![managing deployed applications 38b94](/mulesoft/current/en-us/runtime-manager/_images/managing-deployed-applications-38b94.png)

In the app’s settings page, the **Dashboard** button displays the full detail dashboard for your
application. See [Monitoring Dashboards](https://docs.mulesoft.com/runtime-manager/monitoring-dashboards).

![managing deployed applications 107ad](/mulesoft/current/en-us/runtime-manager/_images/managing-deployed-applications-107ad.png)

> [!NOTE] The **Dashboard** option is available only if your organization has the Anypoint
> Integration Advanced package or a Titanium subscription to Anypoint Platform.

The **Insight** button enables you to see data at a transaction level. See [Insight](https://docs.mulesoft.com/runtime-manager/insight).

![managing deployed applications 76124](/mulesoft/current/en-us/runtime-manager/_images/managing-deployed-applications-76124.png)

> [!NOTE] The dashboard and insights features are not currently available for Anypoint Platform
> Private Cloud Edition. See [Deployment Options](https://docs.mulesoft.com/runtime-manager/deployment-strategies).

## Monitor Applications

The tools you use to monitor application events and server or virtual server performance depend on
the [deployment option](https://docs.mulesoft.com/runtime-manager/deployment-strategies). See [Monitor Applications](https://docs.mulesoft.com/runtime-manager/monitoring).

## Update an Application

If you made changes to your application and want to deploy a new version:

1.  Click **Choose file** on the deployment screen.

2.  Select either **Import file from Exchange** or **Upload file**.

3.  Click **Apply changes**.  
    Within a few seconds, your application redeploys. While redeploying, the application status
    indicator changes to blue, and then turns green after the deployment completes.

4.  For applications deployed to CloudHub, you can click **Logs** to see a live redeployment of your
    application.

If you’re deploying your application to an on-premises cluster, Runtime Manager installs the new app
version simultaneously on each server.

To update applications deployed to Runtime Fabric, see
[Application Versioning on Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning).

### Grace Period

When you stop, restart, update, redeploy, or terminate an application, CloudHub tries to delete it
from Mule. To make sure inflight messages are delivered, there’s a two-minute timeout period. After
that period, CloudHub shuts down the whole instance. This grace period applies to the application
instance, not to the runtime. The runtime uses its own configuration for shutdown. By default, the
runtime grace period is five seconds.

## Alerts

You can set up email alerts that are sent whenever certain events occur to your application, such as
deployment failures or application deletions. These alerts can be linked to a specific application
or to all applications. See [Alerts](https://docs.mulesoft.com/runtime-manager/alerts-on-runtime-manager) for information.

Even if you don’t have permission to create alerts, you can specify whether to receive email alerts.

Switching an alert off from this view switches it off for the current (signed in) user only. Other
users can still have active alerts.

## See Also

- [Manage Applications on CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)

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

- [Send Data from Runtime Manager to External Analytics Software](https://docs.mulesoft.com/runtime-manager/sending-data-from-arm-to-external-analytics-software)

- [Deployment Options](https://docs.mulesoft.com/runtime-manager/deployment-strategies)

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

- [Clustering](https://docs.mulesoft.com/cloudhub/cloudhub-fabric)

- [Manage Queues](https://docs.mulesoft.com/cloudhub/managing-queues)

- [Manage Schedules](https://docs.mulesoft.com/cloudhub/managing-schedules)

- [Manage Application Data Storage with Object Stores](https://docs.mulesoft.com/cloudhub/managing-application-data-with-object-stores)

- [Safely Hide Application Properties](https://docs.mulesoft.com/cloudhub/secure-application-properties)

- [Virtual Private Cloud](https://docs.mulesoft.com/cloudhub/virtual-private-cloud)

- [Penetration Testing Policies](https://docs.mulesoft.com/cloudhub/penetration-testing-policies)

- [Application Versioning on Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)