Skip to main content
Reverse proxy configurations are only supported for Custom plans.
To serve your documentation through a custom reverse proxy, you must configure routing rules, caching policies, and header forwarding. When you implement a reverse proxy, monitor for potential issues with domain verification, SSL certificate provisioning, authentication flows, performance, and analytics tracking.

Routing configuration

Proxy these paths to your Mintlify subdomain with the specified caching policies:

Required header configuration

Configure your reverse proxy with these header requirements:
  • Origin: Contains the target subdomain <your-subdomain>.mintlify.app
  • X-Forwarded-For: Preserves client IP information
  • X-Forwarded-Proto: Preserves original protocol (HTTP/HTTPS)
  • X-Real-IP: Forwards the real client IP address
  • User-Agent: Forwards the user agent
Ensure that the Host header is not forwarded

Example nginx configuration

Troubleshooting

404 error

Symptoms: Documentation loads, but features don’t work. API calls fail. Cause: Host header is being forwarded or Origin header is missing. Solution:
  • Remove Host header forwarding
  • Set Origin header to <your-subdomain>.mintlify.app

Performance issues

Symptoms: Slow page loads and layout shifts. Cause: Incorrect caching configuration. Solution: Enable caching only for /mintlify-assets/_next/static/* paths.