# Proxy

{% hint style="info" %}
Our current support is limited to unauthenticated HTTP Proxies. When your app makes HTTPS connections, the data remains encrypted despite the unencrypted connection to the proxy. The app sends a CONNECT request to the proxy for the destination HTTPS server, initiating an SSL handshake. The proxy acts as a TCP connection forwarder, ensuring end-to-end encryption for app data.<br>

If you need to allow-list specific IPs for proxy access, you can use our [IP Blocks endpoint](/rest-api/ip-blocks.md) to retrieve the necessary IP ranges.
{% endhint %}

## App Level Proxy

Appetize supports settings a proxy server on a per-app basis.

{% hint style="warning" %}
App-Level proxy settings will override the Account **`default proxy`**. if you *always* want the Account-level proxy to be used, use **`forced proxy`** instead.
{% endhint %}

To allow Appetize to proxy all the network events, you need to specify a proxy server to route network traffic to:

### With Query Parameter

Add the `proxy` query parameter to your app or embed URL with your URL encoded proxy server's address (e.g. `http://example.com:8080/`)as value.

```uri
&proxy=http%3A%2F%2Fexample.com%3A8080%2F
```

See [Query Params Reference](/platform/query-params-reference.md#proxy) for more information.

### With JavaScript SDK

Set `proxy` to `http://example.com:8080/` in the configuration e.g.

```typescript
await client.setConfig({
    proxy: "http://example.com:8080",
    ...
})
```

See [Configuration](/javascript-sdk/configuration.md#proxy) for more information.

## Organization Level Proxy

{% hint style="info" %}
Organization Level Proxy is only available on our Premium and Enterprise plans. [Contact us](https://appetize.io/contact-us) to learn more.
{% endhint %}

You may also set organization-wide proxy settings by navigating to [**Organization** **->** **Proxy settings**](https://appetize.io/organization/proxy-settings).

### Default Proxy

By setting a default proxy, the proxy will be used when no other proxy is specified.

<figure><img src="/files/1nfzPUq31hPmjkvqcHLk" alt=""><figcaption><p>Example default proxy</p></figcaption></figure>

### Forced Proxy

By setting a forced proxy, the proxy will be used regardless of other proxy settings.

<figure><img src="/files/OMI1uyDrI8lnvRoCCNdG" alt=""><figcaption><p>Example forced proxy</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appetize.io/features/proxy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.