---
schema_version: "1"
id: 880298542cf8da84a2de2f7940004540bbaf21f856f868214be6a5f44006996f
title: Configure Anypoint Studio to Connect Through a Proxy Server
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/studio/proxy-settings-task.md
canonical_url: https://docs.mulesoft.com/studio/proxy-settings-task
source_site: docs.mulesoft.com
content_type: documentation
content_hash: f7d73c3646533345317e407498c09dc0145d891051b0610fb81ee0f1b65526b9
description: MuleSoft Documentation Site
latest: true
---
---
product: Studio
---

# Configure Anypoint Studio to Connect Through a Proxy Server

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

Configure Anypoint Studio to connect through a proxy server when your computer is behind one and
needs internet access to download plugins and install updates. Studio supports both authenticated
and non-authenticated proxies.

1.  Open the preferences view in the manner appropriate to your OS:

    - In macOS, either navigate to **Anypoint Studio** > **Preferences…​** or press `cmd + ,`.

    - In Windows and Linux, navigate to **Window** > **Preferences…​**.

2.  Under **General** select **Network Connections**.

3.  Select your Active Provider:

    - **Direct** causes Anypoint Studio to open connections without the use of a proxy server.

    - **Manual** causes Anypoint Studio to open connections using the settings defined in the
      options below.

    - **Native** causes Anypoint Studio to open connections using settings discovered in the OS
      where you installed Anypoint Studio.

4.  Click **Edit** when selecting the proxy entry for each schema to configure its host and port
    number.

    If you’re using an authenticated proxy, select **Requires Authentication** and complete the
    **User** and **Password** fields.

5.  If necessary, you can add bypasses to your proxy. This is a list of hosts that should not use
    any proxy.

    Click **Add Host…​** to add hostnames to your proxy bypass list.

    Keep in mind that when setting a manual provider, don’t disable the default `localhost` and
    `127.0.0.1` bypasses. If you disable the bypasses, the embedded Mule runtime within Studio won’t
    be able to reach your application.

When applying changes to your proxy settings, Anypoint Studio restarts the Mule instance used to
obtain metadata and test outbound connections. If this fails, manually restart your instance:
navigate to **Preferences** > **Tooling**, and click **Restart Instance**.

## Proxy Settings Reference

This section describes the options for configuring network connections from Anypoint Studio.

You can access these configuration options from **Preferences…​** > **General** > **Network
Connections**.

![Table of Proxy Connections: Connection, Schema, Provider, and Authorization Status](/mulesoft/current/en-us/studio/_images/proxy-settings-reference-4eeb1.png)

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Option</th><th>Description</th><th>Default Value</th></tr></thead><tbody><tr><td><div><div><p>Active Provider</p></div></div></td><td><div><div><p>Specifies the settings profile to be used when opening connections.</p></div><div><ul><li><p><strong>Direct</strong> causes Anypoint Studio to open connections without the use of a proxy server.</p></li><li><p><strong>Manual</strong> causes Anypoint Studio to open connections using the settings defined in the options below.</p></li><li><p><strong>Native</strong> causes Anypoint Studio to open connections using settings discovered in the OS where Anypoint Studio is running.</p></li></ul></div></div></td><td><div><div><p><strong>Native</strong> if Anypoint Studio detects a proxy configuration in your OS.<br><strong>Direct</strong> if no proxy configuration is detected.</p></div></div></td></tr><tr><td><div><div><p>Proxy Entries</p></div></div></td><td><div><div><p>This table displays entries that are available for all providers. You can check the boxes in the first column for your selected provider to use that entry.</p></div></div></td><td><div><div><p>none</p></div></div></td></tr><tr><td><div><div><p>Proxy Bypass</p></div></div></td><td><div><div><p>This table specifies, either by name or pattern, which hosts should not use any proxy. A direct connection will always be used for matching hosts. You can check the boxes in the first column for your selected provider to use that entry.</p></div></div></td><td><div><div><p><code>localhost</code> and <code>127.0.0.1</code> are marked by default for the Manual provider.<br>Don’t remove this configuration when using a proxy. If you do, the embedded Mule Runtime within Studio won’t be able to reach your application.</p></div></div></td></tr></tbody></table>