---
schema_version: "1"
id: 3e4fa4f6c527f4ec43db1023fe473db57b2d1cf56c8268d179ca2c0c2019997a
title: CLI for Managing Apps in Runtime Fabric
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/anypoint-cli/3.x/runtime-fabric-apps.md
canonical_url: https://docs.mulesoft.com/anypoint-cli/3.x/runtime-fabric-apps
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 07e302562cecc33b5f12df167e0097768c359185c12dfaa1b4a7ed86717f005b
description: MuleSoft Documentation Site
release: 3.x
latest: false
---
---
product: Anypoint CLI
version: 3.x
---

# CLI for Managing Apps in Runtime Fabric

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

Use these commands for managing applications in Runtime Fabric.

<table><colgroup><col> <col></colgroup><thead><tr><th>Command</th><th>Description</th></tr></thead><tbody><tr><td><div><div><p><a href="#runtime-mgr-application-delete">runtime-mgr application delete</a></p></div></div></td><td><div><div><p>Deletes an application</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-deploy">runtime-mgr application deploy</a></p></div></div></td><td><div><div><p>Deploys an application to a specified target using an Exchange application and runs the specified runtime version</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-describe">runtime-mgr application describe</a></p></div></div></td><td><div><div><p>Describes an application</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-describe-json">runtime-mgr application describe-json</a></p></div></div></td><td><div><div><p>Describes an application in a raw JSON response</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-download-logs">runtime-mgr application download-logs</a></p></div></div></td><td><div><div><p>Downloads logs of an application from a specification to a specified directory</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-list">runtime-mgr application list</a></p></div></div></td><td><div><div><p>Lists all applications in an organization</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-modify">runtime-mgr application modify</a></p></div></div></td><td><div><div><p>Modifies a deployed application</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-start">runtime-mgr application start</a></p></div></div></td><td><div><div><p>Starts a stopped application</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-stop">runtime-mgr application stop</a></p></div></div></td><td><div><div><p>Stops running an application</p></div></div></td></tr><tr><td><div><div><p><a href="#runtime-mgr-application-tail-logs">runtime-mgr application tail-logs</a></p></div></div></td><td><div><div><p>Tails an application’s logs from a specification</p></div></div></td></tr></tbody></table>

## runtime-mgr application delete

\> runtime-mgr application delete \[options\] <appID>

Deletes the running application specified in `<appID>`. To get this ID, run the
`runtime-mgr application list` command.

> [!WARNING] This command does not prompt twice before deleting. If you send a delete instruction,
> it does not ask for confirmation.

This command accepts only the default options: `--help`, `-f`/`--fields` and `-o`/`--output`

## runtime-mgr application deploy

\> runtime-mgr application deploy \[options\] <appID> <deploymentTargetID> <runtimeVersion>
<artifactID>

Deploys the application specified in `<appID>` to the deployment target specified using the
following options:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Value</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><div><div><p><code>ArtifactId</code></p></div></div></td><td><div><div><p>Artifact ID of the application retrieved from Exchange.</p></div></div></td><td><div><div><p><code>mule-test-plugin</code></p></div></div></td></tr><tr><td><div><div><p><code>deploymentTargetID</code></p></div></div></td><td><div><div><p>ID of the deployment target.<br>You can get this ID directly from Runtime Manager.</p></div></div></td><td><div><div><p><code>app.runetime</code></p></div></div></td></tr><tr><td><div><div><p><code>name</code></p></div></div></td><td><div><div><p>Name of the application to deploy.</p></div></div></td><td><div><div><p><code>testCloudhub2app</code></p></div></div></td></tr><tr><td><div><div><p><code>runtimeVersion</code></p></div></div></td><td><div><div><p>Runtime version of the deployment target.</p></div></div></td><td><div><div><p><code>1.0.1</code></p></div></div></td></tr></tbody></table>

Besides the default `--help`, `-f`/`--fields` and `-o`/`--output` options, this command also takes
these options:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Value</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><div><div><p><code>assetVersion</code></p></div></div></td><td><div><div><p>Version of the Exchange application to use.<br>Default: latest application version</p></div></div></td><td><div><div><p><code>2.0.4</code></p></div></div></td></tr><tr><td><div><div><p><code>clustered</code></p></div></div></td><td><div><div><p>Enables clustered nodes, which requires at least two replicas.<br>Default:.<code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>false</code></p></div></div></td></tr><tr><td><div><div><p><code>disableAmLogForwarding</code></p></div></div></td><td><div><div><p>Disables forwarding applications logs to Anypoint Monitoring.<br>Default: <code>enabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>forwardSslSession</code></p></div></div></td><td><div><div><p>Enables SSL session forwarding.<br>Default: <code>disabled</code><br>Values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>false</code></p></div></div></td></tr><tr><td><div><div><p><code>groupID</code></p></div></div></td><td><div><div><p>Group ID of the asset to deploy.<br>Default: selected organization ID</p></div></div></td><td><div><div><p><code>org.mule.test</code></p></div></div></td></tr><tr><td><div><div><p><code>javaVersion</code></p></div></div></td><td><div><div><p>Set the name of the JAVA version to be used for the selected Mule version. Supported values are <code>8</code> and <code>17</code>. If you do not specify a value, Runtime Fabric imposes the default value. The default JAVA version for Mule 4.6 and earlier versions is '8'. If you don’t specify a Mule version, the default Mule version for the selected JAVA version is used. If the JAVA version you select is not available for the specified Mule version, you get an error.</p></div></div></td><td><div><div><p><code>8</code></p></div></div></td></tr><tr><td><div><div><p><code>lastMileSecurity</code></p></div></div></td><td><div><div><p>Enables Last Mile Security.<br>Default: <code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>memory</code></p></div></div></td><td><div><div><p>The amount of memory allocated to each replica of a Mule application or API gateway.</p></div></div></td><td><div><div><p><code>0.7</code></p></div></div></td></tr><tr><td><div><div><p><code>objectStoreV2</code></p></div></div></td><td><div><div><p>Enables Object Store v2.<br>Default: <code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>pathRewrite</code></p></div></div></td><td><div><div><p>Supplies the base path expected by the HTTP listener in your application.<br>Format: must begin with <code>/</code></p></div></div></td><td><div><div><p><code>/http://localhost:3000</code></p></div></div></td></tr><tr><td><div><div><p><code>property</code></p></div></div></td><td><div><div><p>Sets a property.<br>Format: <code>name:value</code>. Can be specified multiple times.<br>Enclose the property in quotes and escape the <code>:</code> and <code>=</code> characters.</p></div></div></td><td><div><div><p><code>--property "gcp.privateKey:dGVzdA\=\="</code></p></div></div></td></tr><tr><td><div><div><p><code>propertiesFile</code></p></div></div></td><td><div><div><p>Replaces all properties with values from a selected file.<br>Format: one or more lines in <code>name: value</code> style</p></div></div></td><td><div><div><p><code>/Users/mule/Documents/properties.txt</code></p></div></div></td></tr><tr><td><div><div><p><code>publicEndpoints</code></p></div></div></td><td><div><div><p>Supplies endpoints to reach via the public internet.<br>Format: separated by commas, no spaces</p></div></div></td><td><div><div><p><code>my-superapp-example:/status?limit=10</code></p></div></div></td></tr><tr><td><div><div><p><code>releaseChannel</code></p></div></div></td><td><div><div><p>Set the name of the release channel to be used for the selected Mule version. Supported values are <code>NONE</code>, <code>EDGE</code>, and <code>LTS</code>. If you do not specify a value, Runtime Fabric imposes the default value. The default release channel is <code>EDGE</code>. If you don’t specify a Mule version, the default Mule version for the selected release channel is used. If the selected release channel doesn’t exist, you get an error.</p></div></div></td><td><div><div><p><code>EDGE</code></p></div></div></td></tr><tr><td><div><div><p><code>replicas</code></p></div></div></td><td><div><div><p>Number of replicas. Must be above <code>0</code>.<br>Default: <code>1</code></p></div></div></td><td><div><div><p><code>2</code></p></div></div></td></tr><tr><td><div><div><p><code>replicaSize</code></p></div></div></td><td><div><div><p>Size of replicas in Vcores.<br>Default: <code>0.1</code></p></div></div></td><td><div><div><p><code>0.5</code></p></div></div></td></tr><tr><td><div><div><p><code>reservedCPU</code></p></div></div></td><td><div><div><p>The amount of vCPU guaranteed to the application and reserved for its use.</p></div></div></td><td><div><div><p><code>0.02</code></p></div></div></td></tr><tr><td><div><div><p><code>scopeLoggingConfig</code></p></div></div></td><td><div><div><p>Defines scope logging.<br>Format: <code>scopeName: logLevel</code>, separated by commas, no spaces</p></div></div></td><td><div><div><p><code>testscope1:WARN,testscope2:DEBUG</code></p></div></div></td></tr><tr><td><div><div><p><code>scopeLoggingConfigFile</code></p></div></div></td><td><div><div><p>Uploads a file to define scope logging.<br>Format: one tupple per line, style: <code>{scope: scopeName, logLevel: logLevelType}</code> enclosed with <code>{}</code> <code>()</code> or <code>[]</code></p></div></div></td><td><div><div><p><code>/Users/mule/Documents/cert.txt</code></p></div></div></td></tr><tr><td><div><div><p><code>secureProperty</code></p></div></div></td><td><div><div><p>Sets a secure property.<br>Format: <code>name:value</code>. Can be specified multiple times.<br>Enclose the property in quotes and escape the <code>:</code> and <code>=</code> characters.</p></div></div></td><td><div><div><p><code>--secureProperty "gcp.privateKey:dGVzdA\=\="</code></p></div></div></td></tr><tr><td><div><div><p><code>updateStrategy</code></p></div></div></td><td><div><div><p>Updates the strategy used.<br>Default: <code>rolling</code></p></div></div></td><td><div><div><p><code>recreate</code></p></div></div></td></tr><tr><td><div><div><p><code>vCPULimit</code></p></div></div></td><td><div><div><p>The maximum amount of vCPU the application can use (the level to which it can burst). This is shared CPU on the worker node.</p></div></div></td><td><div><div><p><code>3.9</code></p></div></div></td></tr></tbody></table>

## runtime-mgr application describe

\> runtime-mgr application describe \[options\] <appID>

Displays information about the application specified in `<appID>`. To get this ID, run the
`runtime-mgr application list` command.

This command accepts only the default options: `--help`, `-f`/`--fields` and `-o`/`--output`

## runtime-mgr application describe-json

\> runtime-mgr application describe-json \[options\] <appID>

Displays a raw JSON response from the application specified in `<appID>`. To get this ID, run the
`runtime-mgr application list` command.

This command accepts only the default options: `--help`, `-f`/`--fields` and `-o`/`--output`

## runtime-mgr application download-logs

\> runtime-mgr application download-logs \[options\] <appID> <directory> <specID>

Downloads logs for the application specified in `<appID>` from the specification specified in
`<specID>` to the selected directory.

To get the `<appID>`, run the `runtime-mgr application list` command.

To get the `<specID>` run the `runtime-mgr application describe` command.

This command accepts only the default options: `--help`, `-f`/`--fields` and `-o`/`--output`

## runtime-mgr application list

\> runtime-mgr application list \[options\]

Lists all applications in your organization.

This command accepts only the default options: `--help`, `-f`/`--fields` and `-o`/`--output`

## runtime-mgr application modify

\> runtime-mgr application modify \[options\] <appID> <certificateName>

Updates the settings of an existing application specified in `<appID>`. To get the `<appID>`, run
the `runtime-mgr application list` command.

Besides the default `--help`, `-f`/`--fields` and `-o`/`--output` options, this command also takes
these options:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Value</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><div><div><p><code>ArtifactId</code></p></div></div></td><td><div><div><p>ID of the application retrieved from Exchange.</p></div></div></td><td><div><div><p><code>mule-maven-plugin</code></p></div></div></td></tr><tr><td><div><div><p><code>assetVersion</code></p></div></div></td><td><div><div><p>Version of the Exchange application to use.<br>Default: latest application version</p></div></div></td><td><div><div><p><code>2.0.4</code></p></div></div></td></tr><tr><td><div><div><p><code>clustered</code></p></div></div></td><td><div><div><p>Enables clustered nodes, which requires at least two replicas.<br>Default: <code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>false</code></p></div></div></td></tr><tr><td><div><div><p><code>disableAmLogForwarding</code></p></div></div></td><td><div><div><p>Disables forwarding applications logs to Anypoint Monitoring.<br>Default: <code>enabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>forwardSslSession</code></p></div></div></td><td><div><div><p>Enables SSL session forwarding.<br>Default: <code>disabled</code><br>Values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>false</code></p></div></div></td></tr><tr><td><div><div><p><code>groupID</code></p></div></div></td><td><div><div><p>Group ID of the asset to deploy.<br>Default: selected organization ID.</p></div></div></td><td><div><div><p><code>org.mule.testgroup</code></p></div></div></td></tr><tr><td><div><div><p><code>lastMileSecurity</code></p></div></div></td><td><div><div><p>Enables Last Mile Security.<br>Default: <code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>objectStoreV2</code></p></div></div></td><td><div><div><p>Enables object store v2.<br>Default: <code>disabled</code><br>Supported values: <code>true</code>, <code>false</code></p></div></div></td><td><div><div><p><code>true</code></p></div></div></td></tr><tr><td><div><div><p><code>pathRewrite</code></p></div></div></td><td><div><div><p>Supplies the base path expected by the HTTP listener in your application.<br>Format: must begin with <code>/</code></p></div></div></td><td><div><div><p><code>/http://localhost:3000</code>.</p></div></div></td></tr><tr><td><div><div><p><code>property</code></p></div></div></td><td><div><div><p>Sets a property.<br>Format: <code>name:value</code>. Can be specified multiple times.<br>Enclose the property in quotes and escape the <code>:</code> and <code>=</code> characters.</p></div></div></td><td><div><div><p><code>--property "gcp.privateKey:dGVzdA\=\="</code></p></div></div></td></tr><tr><td><div><div><p><code>propertiesFile</code></p></div></div></td><td><div><div><p>Replaces all properties with values from a selected file.<br>Format: one or more lines in <code>name: value</code> style</p></div></div></td><td><div><div><p><code>/Users/mule/Documents/properties.txt</code></p></div></div></td></tr><tr><td><div><div><p><code>publicEndpoints</code></p></div></div></td><td><div><div><p>Supplies endpoints to reach via the public internet.<br>Format: separated by commas, no spaces</p></div></div></td><td><div><div><p><code>my-superapp-example: /status?limit=10</code></p></div></div></td></tr><tr><td><div><div><p><code>replicas</code></p></div></div></td><td><div><div><p>Number of replicas. Must be above <code>0</code>.<br>Default: <code>1</code></p></div></div></td><td><div><div><p><code>2</code></p></div></div></td></tr><tr><td><div><div><p><code>replicaSize</code></p></div></div></td><td><div><div><p>Size of replicas in Vcores.<br>Default: <code>0.1</code></p></div></div></td><td><div><div><p><code>0.5</code></p></div></div></td></tr><tr><td><div><div><p><code>runtimeVersion</code></p></div></div></td><td><div><div><p>Runtime version of the deployment target.</p></div></div></td><td><div><div><p><code>1.0.1</code></p></div></div></td></tr><tr><td><div><div><p><code>scopeLoggingConfig</code></p></div></div></td><td><div><div><p>Defines scope logging.<br>Format: <code>scopeName: logLevel</code>, separated by commas, no spaces</p></div></div></td><td><div><div><p><code>testscope1:WARN,testscope2:DEBUG</code></p></div></div></td></tr><tr><td><div><div><p><code>scopeLoggingConfigFile</code></p></div></div></td><td><div><div><p>Uploads a file to define scope logging.<br>Format: 1 tupple per line, style: <code>{scope: scopeName, logLevel: logLevelType}</code> enclosed with <code>{}</code> <code>()</code> or <code>[]</code></p></div></div></td><td><div><div><p><code>/Users/mule/Documents/cert.txt</code></p></div></div></td></tr><tr><td><div><div><p><code>secureProperty</code></p></div></div></td><td><div><div><p>Sets a secure property.<br>Format: <code>name:value</code>. Can be specified multiple times.<br>Enclose the property in quotes and escape the <code>:</code> and <code>=</code> characters.</p></div></div></td><td><div><div><p><code>--secureProperty "gcp.privateKey:dGVzdA\=\="</code></p></div></div></td></tr><tr><td><div><div><p><code>updateStrategy</code></p></div></div></td><td><div><div><p>Updates the strategy used.<br>Default: <code>rolling</code></p></div></div></td><td><div><div><p><code>recreate</code></p></div></div></td></tr></tbody></table>

## runtime-mgr application start

\> runtime-mgr application start \[options\] <appid>

Starts running the application specified in `<appid>`. To get this ID, run the
`runtime-mgr application list` command.

This command accepts only the default option `--help`.

## runtime-mgr application stop

\> runtime-mgr application stop \[options\] <appID>

Stops running the application specified in `<appID>`. To get this ID, run the
`runtime-mgr application list` command.

This command accepts only the default option `--help`.

## runtime-mgr application tail-logs

\> runtime-mgr:application:tail-logs \[options\] <appID> <specID>

Tails application logs for the application specificied in `<appID>` from the specification specified
in `<specID>`.

To get the `<appID>`, run the `runtime-mgr application list` command.

To get the `<specID>` run the `runtime-mgr application describe` command.

This command accepts only the default option `--help`.