Skip to main content

Proxy Settings

Configure a proxy server to route your API requests through an intermediary. This is useful when you're behind a corporate firewall, debugging traffic with tools like Charles or Fiddler, or connecting through a VPN.

Open proxy settings in Settings → Proxy.

Enabling the Proxy​

Toggle Use Proxy to on. When enabled, all HTTP and HTTPS requests sent from Rostyman will be routed through the configured proxy server.

When disabled, requests connect directly to the target server as usual.

Configuration​

SettingDescription
ProtocolThe proxy protocol: HTTP, HTTPS, or SOCKS5
HostThe proxy server hostname or IP address (e.g. 127.0.0.1, proxy.company.com)
PortThe proxy server port (e.g. 8080, 1080)
UsernameOptional — for proxies that require authentication
PasswordOptional — proxy authentication password

Protocol Options​

  • HTTP — Standard HTTP proxy. Most common for corporate networks and debugging tools.
  • HTTPS — Encrypted connection to the proxy server itself. Use when your proxy requires a secure connection.
  • SOCKS5 — A lower-level proxy protocol that supports any type of traffic. Commonly used with SSH tunnels and some VPN configurations.

Common Scenarios​

Corporate Network or VPN​

Many corporate environments require all traffic to pass through a company proxy. Ask your IT department for the proxy host, port, and credentials, then enter them in Rostyman's proxy settings.

Debugging with Charles Proxy​

  1. Start Charles Proxy (default port: 8888)
  2. In Rostyman, enable the proxy and set:
    • Protocol: HTTP
    • Host: 127.0.0.1
    • Port: 8888
  3. Your requests will now appear in Charles for inspection

Debugging with Fiddler​

  1. Start Fiddler (default port: 8866)
  2. In Rostyman, enable the proxy and set:
    • Protocol: HTTP
    • Host: 127.0.0.1
    • Port: 8866
  3. Fiddler will capture and display all request/response traffic

Using an SSH SOCKS Tunnel​

If you've set up an SSH tunnel (e.g. ssh -D 1080 user@server):

  1. Enable the proxy and set:
    • Protocol: SOCKS5
    • Host: 127.0.0.1
    • Port: 1080
  2. Requests will be tunneled through your SSH connection

Tips​

  • Proxy settings apply globally to all requests in Rostyman.
  • If you're having connection issues with the proxy enabled, try disabling it temporarily to confirm whether the proxy is the cause.
  • When using HTTPS proxies or intercepting tools, you may also need to disable SSL Verification in General Settings or add the proxy's CA certificate in Certificates.