Reverse proxy configurations are only supported for Custom plans.
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
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
Hostheader forwarding - Set
Originheader 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.