---
schema_version: "1"
id: 06d40e6e9cb1c784b01e2b8d19a6d135bafa29aa56f4feebfaab3a4e6a381bb9
title: Deploy Your API Proxy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/api-manager/latest/proxy-latest-concept.md
canonical_url: https://docs.mulesoft.com/api-manager/latest/proxy-latest-concept
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 118513f735d98e3935edb94df55092654f9d40ddd5cad5c0b5e2444a08289352
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
---
product: API Manager
version: 2.x
is-latest-version: true
---

# Deploy Your API Proxy

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

You can deploy your API proxy to CloudHub, Runtime Fabric, or a hybrid cloud environment. The
resources allocated to the proxy application varies based on the type of proxy you are using. For
example, the CloudHub proxy includes a CPU with 0.1 vCores and a memory of 500 MB, by default.

If required, modify the resource allocation from
[Runtime Manager](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub#change-settings-of-a-deployed-application.adoc).

## Prerequisites

Before you deploy your API proxy, complete the following requirements if you work in a Runtime
Fabric or hybrid cloud environment:

- Runtime Fabric

  - Obtain the Manage APIs Configuration and Deploy API Proxies permissions on your account.

  - Use Mule version 4.1.2 or later.

- Hybrid:

  - For private servers, obtain access to a Mule runtime engine (Mule) instance configured for your
    organization.

    For information about how to configure a Mule instance as a server, see
    [register a server in Runtime Manager](https://docs.mulesoft.com/runtime-manager/servers-create).

  - Register your private server with a Mule agent that is compatible with your Mule instance.

    Use the Mule Agent specified in the release notes.

## Deploy Your API Proxy

Deploy your proxy by completing the following steps:

1.  Navigate to **Anypoint Platform** > **API Manager**.

2.  In **API Administration**, click **Add API** and select **Add new API**.

3.  Select **Mule Gateway** as your runtime.

4.  Select **Deploy a proxy application** for **Proxy type**.

5.  If you selected to deploy a proxy application, select the **Target type** from the following
    options:

    - **CloudHub 2.0**: Select this option if you want to use the Mule runtime hosted by MuleSoft in
      a container-based cloud infrastructure. The CloudHub 2.0 proxy includes a CPU with 0.1 vCores
      by default.

      1.  Select a space.

          To learn more about spaces, see [Shared Spaces](https://docs.mulesoft.com/cloudhub-2/ch2-shared-space-about)
          and [Private Spaces](https://docs.mulesoft.com/cloudhub-2/ch2-private-space-about).

      2.  In **Runtime version**:

          1.  Select the **Runtime Channel**.

          2.  Select the **Version** for Mule runtime.

          3.  Select the **Java version**.

      3.  Enter a **Proxy app name**.

    - **CloudHub**: Select this option if you want to use the Mule runtime hosted on the cloud by
      MuleSoft. The CloudHub proxy includes a CPU with 0.1 vCores and a memory of 500 MB, by
      default.

      1.  In **Runtime version**:

          1.  Select the **Runtime Channel**.

          2.  Select the **Version** for Mule runtime.

          3.  Select the **Java version**.

      2.  Enter a **Proxy app name**.

    - **Hybrid:** Select this option if you want to use a Mule runtime instance running on an
      on-premises server that is registered in Runtime Manager.

      See [Register a server in Runtime Manager](https://docs.mulesoft.com/runtime-manager/servers-create) for more
      information.

      1.  Select a target from the list or click **Add server**.

      2.  Enter a **Proxy app name**.

    - **Self-managed Server:** Select this option if you want to create a JAR file to deploy an API
      proxy to a Mule runtime instance running on an on-premises server that is not registered in
      Runtime Manager. For more information, see
      [On-Premises Mule Runtime Deployment Model](https://docs.mulesoft.com/on-premises/latest/mule-deployment-model).

Deploying an API proxy to a self-managed server in API Manager doesn’t deploy the proxy to your
on-premises server. After you deploy the proxy in API Manager, deploy the proxy to your on-premises
server: . [Download your new API proxy JAR file](https://docs.mulesoft.com/api-manager/latest/download-proxy-task). .
[Deploy the JAR file to your on-premises server](https://docs.mulesoft.com/mule-runtime/latest/deploy-on-premises).

- **Runtime Fabric:** Select Runtime Fabric if you want to deploy API Proxies to a Mule runtime
  engine that is managed on Runtime Fabric. See
  [Deploying API Proxies to Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/proxy-deploy-runtime-fabric)
  for more information.

  1.  Select a target from the list.

  2.  In **Runtime version**:

      1.  Select the **Runtime Channel**.

      2.  Select the **Version** for Mule runtime.

      3.  Select the **Java version**.

  3.  Enter a **Proxy app name**.

      1.  Select an API from the following options:

- Click **Select API from Exchange** if you have an API shared with you through Exchange that you
  want to manage.

  1.  Click the API from the list under **Select API**. You can search for a specific API if needed.

  2.  Update the **Asset type**, **API version**, and **Asset version** if you are not using the
      latest version.

      For more information about versions in Exchange, see
      [Asset Versions](https://docs.mulesoft.com/exchange/asset-versions).

  3.  If you chose a **RAML/OAS** asset type, view the **Conformance Status** of the API to ensure
      the API is conformant. If the **Conformance Status** is nonconformant, after deployment, view
      the **Governance Report** to find and fix the conformance issues. For more information about
      the **Governance Report**, see [Governing API Instances](https://docs.mulesoft.com/api-manager/latest/govern-api-instances).

- Click **Create new API**:

  1.  Enter a **Name** for the new API asset.

  2.  Select the **Asset type** from the following options:

      - **REST API:** Select this option if you have a RAML or OAS API definition file you want to
        include for your asset.

        Upload either a RAML or OAS file for your REST API. Versions 2.0.0 and later are the
        recommended versions for OAS or RAML specs, because these versions add native OAS support.
        If you upload an OAS API specification to an API proxy version 1.0 or earlier, your API
        specification is translated to RAML.

      - **HTTP API:** Select this option if you do not have an API definition file you want to
        include for your asset. For WebSocket APIs, select HTTP and then choose the WebSocket
        subtype when selecting the API from Exchange. WebSocket instances can use HTTP or AsyncAPI
        assets from Exchange.

      - **SOAP API:** Select this option if you have a WSDL API definition file or an external link
        to the file.

        Upload a WSDL file for your SOAP API or add the link to the file.

      - **GraphQL API:** Select this option if you have a GraphQL schema definition file you want to
        include for your asset.

        Upload the GraphQL schema definition for your GraphQL API.

  3.  Update the **Asset type**, **API version**, and **Asset version** if you are not using the
      latest version.

      For more information about versions in Exchange, see
      [Asset Versions](https://docs.mulesoft.com/exchange/asset-versions).

  4.  If you chose a **RAML/OAS** asset type, view the **Conformance Status** of the API to ensure
      the API is conformant. If the **Conformance Status** is nonconformant, after deployment, view
      the **Governance Report** to find and fix the conformance issues. For more information about
      the **Governance Report**, see [Governing API Instances](https://docs.mulesoft.com/api-manager/latest/govern-api-instances).

      1.  Click **Next**.

      2.  Configure the downstream configuration settings:

          Expand for configuration settings.

          <table><colgroup><col> <col> <col> <col></colgroup><thead><tr><th>Field Name</th><th>Description</th><th>Required</th><th>Notes</th></tr></thead><tbody><tr><td><p><strong>Protocol</strong></p></td><td><p>Specifies whether to use HTTP or HTTPS for the validations.</p></td><td><p>Yes</p></td><td><p>If you select HTTPS, specify a TLS context for inbound traffic.</p></td></tr><tr><td><p><strong>Inbound TLS</strong></p></td><td><p>Specifies the TLS context to secure inbound traffic.</p></td><td><p>No</p></td><td><p>If you can’t see a context, ensure that you have the correct permissions.</p></td></tr><tr><td><p><strong>Port</strong></p></td><td><p>Specifies the number to use if the displayed port is incorrect.</p></td><td><p>Yes</p></td><td></td></tr><tr><td><p><strong>Base path</strong></p></td><td><p>Specifies the URL prefix for all API paths, relative to the host root. It must start and end with a leading slash <code>/</code>. If the final slash isn’t provided, the system adds it automatically.</p></td><td><p>Yes</p></td><td></td></tr><tr><td><p><strong>Instance label</strong></p></td><td><p>Specifies a label for the API.</p></td><td><p>No</p></td><td><p>If you have multiple managed instances of the same API, add a label to differentiate each instance from the others.</p></td></tr><tr><td><p><strong>Advanced Options</strong></p></td><td></td><td></td><td></td></tr><tr><td><p><strong>Consumer endpoint</strong></p></td><td><p>Specifies a proxy application’s address for consumers to use for sending requests.</p></td><td><p>No</p></td><td></td></tr><tr><td><p><strong>Client provider</strong></p></td><td><p>Specifies a client provider for the API.</p></td><td><p>Yes</p></td><td><p>Anypoint Platform acts as the client provider by default. To configure an external client provider, see <a href="https://docs.mulesoft.com/access-management/managing-api-clients">Client Providers</a>.</p></td></tr><tr><td><p><strong>Request timeout</strong></p></td><td><p>Specifies the duration after which a request times out.</p></td><td><p>No</p></td><td></td></tr><tr><td><p><strong>Proxy Version</strong></p></td><td><p>Specifies the version of the proxy to use for the endpoint.</p></td><td><p>No</p></td><td></td></tr><tr><td><p><strong>Service Name</strong></p></td><td><p>Name of your WSDL service.</p></td><td><p>Yes</p></td><td><p>Only avaliable for WSDL APIs.</p></td></tr><tr><td><p><strong>Service Port</strong></p></td><td><p>Port for your WSDL your service.</p></td><td><p>Yes</p></td><td><p>Only avaliable for WSDL APIs.</p></td></tr><tr><td><p><strong>Service Namespace</strong></p></td><td><p>Namespace of your WSDL service.</p></td><td><p>Yes</p></td><td><p>Only avaliable for WSDL APIs.</p></td></tr><tr><td><p><strong>Enable Console</strong></p></td><td><p>Specifies whether you can expose and test your API specification.</p></td><td><p>No</p></td><td><p>You can specify a different path in <strong>Console Path</strong>, for example, <code>/spec/*</code>. Only available if you have an attached API definition.</p></td></tr><tr><td><p><strong>Validations</strong></p></td><td><p>Specifies whether to validate inbound requests against a provided specification.</p></td><td><p>No</p></td><td><p>Only available if you have an attached API definition.</p></td></tr><tr><td><p><strong>Strict validations (optional)</strong></p></td><td><p>Specifies whether to validate inbound requests against query parameters.</p></td><td><p>No</p></td><td><p>Only available if you have an attached API definition.</p></td></tr><tr><td><p><strong>User Domain</strong></p></td><td><p>Specifies whether to use an API gateway domain.</p></td><td><p>No</p></td><td><p>If you chose <strong>Hybrid</strong> as the proxy deployment target previously in the configuration, ensure that you select this option.</p></td></tr></tbody></table>

      3.  Click **Next**.

      4.  Configure the upstream configuration settings:

          Expand for configuration settings.

          <table><colgroup><col> <col> <col> <col></colgroup><thead><tr><th>Field Name</th><th>Description</th><th>Required</th><th>Notes</th></tr></thead><tbody><tr><td><p><strong>Upstream URL</strong></p></td><td><p>The URL to access for the proxy or the API.</p></td><td><p>Yes</p></td><td><p>For example, you can use the URL of your API asset in Exchange.</p></td></tr><tr><td><p><strong>Outbound TLS</strong></p></td><td><p>Specifies the TLS context to secure outbound traffic.</p></td><td><p>No</p></td><td><p>If you can’t see a context, ensure that you have the correct permissions.</p></td></tr></tbody></table>

      5.  Click **Next**.

      6.  Review your selections and edit them if necessary.

      7.  If you are ready to deploy, click **Save & Deploy**. Otherwise, you can select **Save**,
          to save the instance and deploy it at a later time.

## See Also

- [Configuring an HTTPS Endpoint](https://docs.mulesoft.com/api-manager/latest/https-reference)
