Subpath Hosting
Host your docs at yoursite.com/docs instead of a separate subdomain. Includes Vercel, CloudFront, Cloudflare, and reverse proxy setups.
Host your docs at yoursite.com/docs instead of a separate subdomain. For all deployment options, see Deployment Overview.
Why Use a Subpath?
Hosting docs at yoursite.com/docs instead of a subdomain like docs.yoursite.com provides:
- Better SEO - Documentation pages contribute to your main domain's authority
- Unified experience - Users stay on your primary domain
- Simpler navigation - No context switching between domains
How It Works
Your web server or CDN proxies requests from /docs/* to your Jamdesk site while preserving the original URL in the browser:
The proxy passes the X-Jamdesk-Forwarded-Host header with your domain. Jamdesk uses this to:
- Verify your domain is authorized to serve the content
- Apply your configuration from the dashboard
This means your proxy configuration is a one-time setup - if you change settings in the dashboard, the proxy doesn't need to be updated.
Setup by Provider
Choose your hosting provider to get started:
Prerequisites
Before configuring your proxy:
- Enable subpath hosting in your Jamdesk dashboard under Settings → Custom Domain
- Toggle "Host at /docs" to on
- Add your domain (e.g.,
yoursite.com)
Your Jamdesk subdomain (e.g., acme.jamdesk.app) will be displayed in the dashboard - you'll need this for your proxy configuration.
Toggling "Host at /docs" on or off triggers an automatic rebuild of your documentation. This is required because the URL structure changes between /introduction and /docs/introduction.
Once you've configured your proxy, test by visiting https://yoursite.com/docs. Your documentation should load with all assets and links working correctly.