Subfolder Hosting

nginx
server {    listen 443 ssl;    server_name yourcompany.com;    # Your main site    location / {        # ... your existing configuration    }    # Proxy documentation to HolyDocs    location /docs/ {        proxy_pass https://your-project.holydocs.com/;        proxy_set_header Host your-project.holydocs.com;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;        proxy_set_header X-Forwarded-Host $host;        proxy_set_header X-Base-Path /docs;        proxy_ssl_server_name on;    }    # Handle /docs without trailing slash    location = /docs {        return 301 /docs/;    }}

The trailing slash on proxy_pass is important. proxy_pass https://your-project.holydocs.com/ (with trailing slash) strips the /docs/ prefix from the forwarded request. Without it, the full path including /docs/ is forwarded.

Add a rewrites rule to your vercel.json:

json
{  "rewrites": [    {      "source": "/docs/:path*",      "destination": "https://your-project.holydocs.com/:path*"    }  ]}

If your Vercel project uses Next.js, add the rewrite to next.config.js instead:

javascript
module.exports = {  async rewrites() {    return [      {        source: '/docs/:path*',        destination: 'https://your-project.holydocs.com/:path*',      },    ];  },};

If your main site is on Cloudflare, create a Worker to proxy documentation requests:

javascript
export default {  async fetch(request) {    const url = new URL(request.url);    // Proxy /docs/* to HolyDocs    if (url.pathname === '/docs' || url.pathname.startsWith('/docs/')) {      const docsPath = url.pathname.replace(/^\/docs/, '') || '/';      const docsUrl = new URL(docsPath, 'https://your-project.holydocs.com');      docsUrl.search = url.search;      const headers = new Headers(request.headers);      headers.set('X-Forwarded-Host', url.host);      headers.set('X-Forwarded-Proto', url.protocol.replace(':', ''));      return fetch(docsUrl.toString(), {        method: request.method,        headers,        body: request.body,        redirect: 'manual',      });    }    // Pass through to origin for everything else    return fetch(request);  },};

Attach this Worker via a Route to yourcompany.com/docs/* so it only runs on documentation requests.

Add a rewrite rule to your netlify.toml:

toml
[[redirects]]  from = "/docs/*"  to = "https://your-project.holydocs.com/:splat"  status = 200  force = true

Or add to your _redirects file:

text
/docs/*  https://your-project.holydocs.com/:splat  200

apache
<VirtualHost *:443>    ServerName yourcompany.com    # Enable proxy + header modules (a2enmod proxy proxy_http headers)    ProxyRequests Off    SSLProxyEngine On    # Proxy documentation to HolyDocs    ProxyPass /docs/ https://your-project.holydocs.com/    ProxyPassReverse /docs/ https://your-project.holydocs.com/    # Tell HolyDocs what the public URL is so canonical/og tags are correct    RequestHeader set X-Forwarded-Host "%{HTTP_HOST}s"    RequestHeader set X-Forwarded-Proto "https"    # Handle /docs without trailing slash    RedirectMatch 301 ^/docs$ /docs/    # Your main site configuration    # ...</VirtualHost>

text
yourcompany.com {    # Proxy /docs to HolyDocs    handle_path /docs/* {        reverse_proxy https://your-project.holydocs.com {            header_up Host your-project.holydocs.com            header_up X-Forwarded-Host {host}            header_up X-Forwarded-Proto {scheme}        }    }    # Redirect /docs to /docs/    @docspath path /docs    redir @docspath /docs/    # Your main site    handle {        # ... your existing configuration    }}