Proxy

OpenUsage can route all provider requests through an optional proxy.

Config file

{
  "proxy": {
    "enabled": true,
    "url": "socks5://127.0.0.1:10808"
  }
}

Authenticated proxies put credentials in the URL:

{
  "proxy": {
    "enabled": true,
    "url": "http://user:pass@proxy.example.com:8080"
  }
}

When the URL has no port, the scheme's default applies (socks5 → 1080, http → 80, https → 443).

The config is read once at launch — restart OpenUsage after changing the file.
localhost, 127.0.0.1, and ::1 always bypass the proxy (the local HTTP API is unaffected).
A missing, disabled, invalid, or unreadable config simply leaves proxying off.

Applies to provider HTTP requests made by the app, including the daily model pricing refresh. It is not a system-wide proxy.