Home

Proxy Settings

Configure proxy settings for your API requests.

Overview

Proxy settings allow you to route your API requests through a proxy server. This is useful for:

  • Web App: Bypass CORS restrictions that block browser requests
  • Desktop App: Route traffic through a specific server for debugging or compliance
  • Both: Access APIs that are only reachable from the proxy server's network

Configuration

To configure proxy settings, open the Settings modal (Ctrl/Cmd + ,) and navigate to the Request Proxy section.

Proxy Profiles

Echolon uses proxy profiles to manage different proxy configurations. You can select from:

  • No Proxy: Send requests directly without proxying (default)
  • Echolon Proxy: Use the built-in Echolon proxy service
  • Custom Proxy: Add your own proxy server

Echolon Proxy

The Echolon Proxy is a built-in proxy service provided by Echolon at https://proxy.echolon.app. It's pre-configured and ready to use.

This proxy is particularly useful for the web app to bypass CORS restrictions. When enabled, your requests are automatically routed through the Echolon proxy server.

Custom Proxy

You can add custom proxy profiles for your own proxy servers. To add a custom proxy:

  1. Click the + button next to the proxy profile dropdown
  2. Enter a name for your proxy profile (e.g., "Company Proxy")
  3. Enter the proxy URL (e.g., https://proxy.example.com)
  4. Click Create Profile

Once created, you can select your custom proxy from the dropdown. Custom proxy URLs can be edited or deleted at any time.

How It Works

When a proxy is enabled, Echolon transforms your request URLs before sending them. The transformation depends on the proxy type:

Echolon Proxy Format

The Echolon proxy uses a path-based format: 

proxy.echolon.app/{scheme}/{host}/{path}

For example, a request to: 

https://api.github.com/repos/octocat/hello-world

Would be transformed to: 

https://proxy.echolon.app/https/api.github.com/repos/octocat/hello-world

Custom Proxy Formats

Custom proxies support multiple URL formats:

  • Query parameter format: https://proxy.com/?url= — The target URL is appended as a query parameter
  • Simple prefix format: https://proxy.com/ — The target URL is appended directly
  • Echolon format: Custom proxies that use the same path-based format as Echolon proxy

Echolon automatically detects the proxy format and applies the appropriate transformation.