Network & Proxy

Narratorr can route outbound requests through a proxy. This is useful for privacy, accessing region-restricted metadata, or routing traffic through a VPN.

Configure the global proxy in the Network section of Settings > General.

Proxy URL

Setting	Description
Proxy URL	Full proxy URL including protocol. Supports http://, https://, and socks5://.

Examples:

• http://proxy.local:8080
• socks5://user:pass@proxy.local:1080
• http://user:pass@proxy.local:3128

Click Test Proxy to verify connectivity. Narratorr will resolve the proxy’s external IP and display it.

Tip

Credentials in the proxy URL are encrypted at rest in the database and redacted from log output.

What Gets Proxied

The global proxy applies only to indexer search and test requests, and only for indexers that have opted in via the per-indexer Route through proxy toggle (see below).

It does not apply to:

• Metadata provider lookups and cover-art downloads
• Download client communication (these are typically on your local network)
• SSE connections to the browser

Caution

Setting a global Proxy URL alone has no effect. After saving it, you must enable Route through proxy on each indexer (Settings > Indexers) that should use it. The global URL stays inert until at least one indexer opts in.

Per-Indexer Transport Options

Each indexer has two independent transport settings in Settings > Indexers:

• Route through proxy — sends that indexer’s search and test requests through the global Network proxy configured above. This is the toggle that activates the global Proxy URL for an indexer.
• FlareSolverr URL — routes that indexer’s requests through a FlareSolverr instance to bypass Cloudflare. This is a Cloudflare-bypass mechanism, not an HTTP/SOCKS proxy.

FlareSolverr is a separate service you run alongside Narratorr. It handles Cloudflare-protected sites by running a headless browser to solve challenges. If both Route through proxy and FlareSolverr URL are set on the same indexer, FlareSolverr takes precedence.

Note

FlareSolverr is a per-indexer setting, not a global one. Only configure it on indexers that require Cloudflare bypass. Standard Torznab/Newznab indexers don’t need it.

Docker Networking

If Narratorr and your proxy run in Docker, use the container name as the proxy host:

services:
  narratorr:
    environment:
      # No env var for proxy — configure in Settings > General (Network section)
    networks:
      - media

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    ports:
      - "8191:8191"
    networks:
      - media

networks:
  media:

Then in Settings > Indexers, set FlareSolverr URL to http://flaresolverr:8191.