Host docs at a subpath

Host your Mintlify documentation at a subpath like /docs on your main domain using Cloudflare Workers, Vercel rewrites, or an nginx reverse proxy.

Host your documentation at a subpath like your-domain.com/docs to keep your docs on your main domain, which makes them easier to find and maintains a cohesive brand experience for your users.

Let Mintlify manage your domain

If your domain hosts nothing else, Mintlify can serve your documentation at your subpath without a proxy. On the Custom domain setup page in your dashboard, enable the Host at toggle, enter your base path, and add your domain. Then configure the DNS records shown in your dashboard to point your domain at Mintlify. See Custom domain for setup instructions.

Only use this option if Mintlify can receive all paths on the domain.

Set up by hosting provider

If another site runs on your domain, configure your hosting provider to proxy your subpath to Mintlify. Choose your hosting provider and follow the setup instructions.

• Cloudflare: Set up Cloudflare Workers for your domain to serve your documentation at your subpath.
• AWS Route 53 and CloudFront: Deploy your documentation at your subpath using AWS with Route 53 DNS and CloudFront CDN.
• Vercel: Use rewrites to deploy your documentation at your subpath.
• Custom reverse proxy: For other hosting platforms, set up a reverse proxy to deploy your documentation at your subpath.

Additional configuration for strict security policies

If you proxy all traffic on your custom domain, you may need to configure your proxy or firewall rules to add the correct headers so your documentation displays properly.