User documentation
  1. What is redirection.io?
  2. Starter's guide
  3. What are organizations and projects?
  4. Invite new collaborators
  5. User account and preferences
  6. Using traffic logs
  7. Create a rule
  8. Triggers and markers reference
  9. Actions reference
  10. How to bulk-import or export redirection rules?
  11. Managing instances
  12. Project notifications
  13. Project segmentation
  14. How much does it cost?
  15. Can I use redirection.io for free?
  16. About us
Developer documentation
  1. TL;DR; Fast track
  2. Available integrations
  3. nginx module
  4. Apache module
  5. platform.sh integration
  6. Cloudflare Workers integration
  7. Fastly Compute@Edge integration
  8. Vercel Middleware Integration
  9. Using redirection.io with Docker
  10. How fast is it?
  11. Public API
Agent documentation
  1. Installing the agent
  2. Upgrading the agent
  3. Agent command line options
  4. The agent as a reverse proxy
  5. Agent configuration reference
  6. Minimal configuration
  7. Listening for requests
  8. Forwarding requests to the backend
  9. Virtualhosts
  10. Trusted proxies
  11. GeoIP database
  12. Response compression
  13. Performance tweaks
  14. Access logs
  15. Persisting data in a s3 bucket
  16. Monitoring the agent
  17. Using the agent behind a HTTPS proxy
  18. Agent configuration examples
Managed instances
  1. What are managed instances?
  2. Add a domain to your project
  3. Managed instances limits and quota
  4. Frequently asked questions
Crawler
  1. What is the redirection.io crawler?
  2. Start a crawl
  3. Schedule a crawl
  4. Analyzing the results of a crawl
  5. The crawls list
  6. Crawl credits and pricing
  7. Crawl Errors
  8. Crawler metrics reference
  9. Crawler columns reference
Knowledge base
  1. Create your first redirections
  2. redirection.io rules cookbook
  3. Setting up a redirection server on Azure Cloud
  4. Structured data and Rich Snippets
  5. What is a URL redirection?
  6. Why use URL redirections and how to setup
Legacy versions
  1. Agent 1.x configuration reference
  2. Agent 2.x configuration reference
  3. Legacy integrations
  4. Legacy Cloudflare Workers integration
Changelogs
  1. redirectionio-agent
  2. libnginx-mod-redirectionio
  3. libapache2-mod-redirectionio

Agent documentation

This section contains detailed technical documentation about how to install, configure and run the redirection.io agent (version 3). It provides many examples and insights to understand the different ways of integrating the redirection.io agent in your infrastructure.

  • Installing the agent

    Learn how to install the redirection.io agent, the software that we provide to store redirect rules on your website's infrastructure, and apply them in a very performant way on incoming HTTP requests.

  • Upgrading the agent

    Read the required steps to successfully upgrade the redirectionio-agent. the agent often receives updates, new features or improvements, and we strongly encourage our customers to apply updates on a frequent basis.

  • Agent command line options

    Explore redirection.io agent command line options to test configurations, enable debug mode, and manage service reloads via the CLI.

  • The agent as a reverse proxy

    Learn how to run the redirection.io agent as a very performant and reliable SEO reverse proxy in front of your website.

  • Agent configuration reference

    This page gives the reference of all the redirectionio-agent configuration directives, with detailed explanations.

  • Minimal configuration

    This example shows a minimal configuration, with only the required options.

  • Listening for requests

    Configure the redirection.io reverse proxy to handle HTTP, HTTPS, and HTTP3 (QUIC) with automated Let's Encrypt or custom SSL certificates.

  • Forwarding requests to the backend

    Configure how the redirection.io agent forwards requests to backends, including TLS, IPv6, persistent connections, and local file serving.

  • Virtualhosts

    Learn how to configure Virtualhosts in redirection.io to host multiple websites and domains with specific backends and project keys.

  • Trusted proxies

    Configure trusted_proxies in redirection.io to correctly identify client IP addresses from headers like X-Forwarded-For behind a CDN or LB.

  • GeoIP database

    This page explains how to configure a .mmdb database in the redirection.io agent, to add geolocation headers to requests on the fly.

  • Response compression

    This page focuses on the ability of the redirection.io agent reverse proxy to compress the responses sent to the clients.

  • Performance tweaks

    Optimize redirection.io agent performance and memory usage by configuring performance options.

  • Access logs

    Configure access_log in the redirection.io agent to monitor traffic using JSON, text, or syslog, with global or Virtualhost level settings

  • Persisting data in a s3 bucket

    This page explains how to store the agent persistent information in a s3 bucket

  • Monitoring the agent

    Monitor redirection.io agent health and performance using technical logs and Prometheus metrics for real-time traffic and resource tracking

  • Using the agent behind a HTTPS proxy

    Learn how to configure a proxy for the redirection.io agent using HTTPS_PROXY environment variables and systemd service overrides

Can't find your answer?