Skip to main content

​
Config priority

Settings are resolved in this order (highest wins):
PrioritySource
1CLI flags (--port, --log-level, etc.)
2server: block in the YAML config file
3PROXY_HOPPER_* environment variables
4Built-in defaults

​
File structure

proxyProviders:   # optional — named providers with auth and region tags
  - ...

ipPools:          # optional — named pools that draw IPs from providers
  - ...

targets:          # required — one or more URL-matching rules
  - ...

server:           # optional — all fields have defaults
  ...
See the dedicated pages for each section:

Proxy providers

Named proxy suppliers with credentials and region tags.

IP pools

Named pools that draw IPs from providers.

Targets

URL-matching rules that control routing and retry behaviour.

Server settings

Host, port, backend, logging, metrics, and probe settings.

​
Duration values

All duration fields accept a suffix (1s, 5m, 2h) or a bare integer (seconds). 
minRequestInterval: 1s    # one second
maxQueueWait: 30s         # thirty seconds
quarantineTime: 2m        # two minutes