Agent configuration examples

The following examples are good starting points for configuring the redirection.io agent.

• Access logs

  A configuration example to enable access logs in the redirection.io agent's reverse proxy

• ACME certificates

  A configuration example enabling automatic certificate management with ACME (Let's Encrypt)

• Application logs outputs

  A configuration example showing multiple global log outputs and formats.

• File and ACME certificates

  A configuration example combining local certificate files with ACME settings

• File-based certificates

  A configuration example loading TLS certificates and key from local files

• Forward to a TLS backend

  A configuration example to connect securely to an HTTPS upstream with TLS options.

• Forward to HTTP backend

  A configuration example to forward reverse proxy traffic to an HTTP upstream service

• Full example

  A complete full-featured configuration example that showcases most of the redirection.io agent features.

• GeoIP header injection

  A configuration example to enrich requests with GeoIP-derived headers

• HTTP response compression

  A configuration example enabling compression for reverse proxy HTTP responses.

• IPv6 upstream forwarding

  A configuration example to allow IPv6 resolution and connection for upstream forwarding.

• Limiting the memory

  The page presents several configuration directives that can help limiting the memory used by the agent

• Metrics endpoint

  A configuration example exposing a metrics listener for monitoring.

• Minimal configuration

  The smallest possible redirection.io configuration, with only an instance name.

• Per Virtualhost access logs

  This example showcases how to handle separate access logs configuration, Virtualhost per Virtualhost.

• Performance tuning

  A configuration example adjusting thread and blocking worker settings for reverse proxy

• Persisting on a S3 bucket

  This example shows how to persist the agent information (rules, SSL certificates, etc.) in a S3 bucket instead of the local disk

• Reverse proxy on HTTP

  A configuration example to expose the reverse proxy on plain HTTP.

• Reverse proxy on HTTP and TLS

  A configuration example that listens on both HTTP and HTTPS

• Reverse proxy on HTTP, TLS, and QUIC

  A configuration example enabling HTTP, HTTPS, and QUIC listeners together.

• Reverse proxy on TLS

  A configuration example to expose the reverse proxy on HTTPS/TLS

• Serve a local directory

  A configuration example to serve files directly from a local directory instead of an upstream address.

• Server mode

  An example that shows how to run the agent in server mode

• Trusted proxies and forwarded headers

  A configuration example to trust specific proxy IP ranges and control "forwarded" headers handling

• Upstream forwarding timeouts

  A configuration example defining explicit timeout values for DNS, connect, handshake, request, and response phases.

• Upstream keep-alive

  A configuration example enabling keep-alive to reuse upstream connections.

• Upstream keep-alive - detailed tuning

  A configuration example with detailed keep-alive limits and timeouts for upstream connections.

• Virtualhosts with per-domain behavior

  A configuration example routing multiple domains with domain-specific project keys and forwarding behavior