Host documentation at a /docs subdirectory using AWS services
/docs
subpath using AWS Route 53 and CloudFront, you need to configure your DNS provider to point to your CloudFront distribution.
/.well-known/acme-challenge/*
- Required for Let’s Encrypt certificate verification/.well-known/vercel/*
- Required for Vercel domain verificationHOST
header and client IP information correctly. This is critical for Vercel’s verification processes.
VercelCloudFrontProxy
.Origin
and CloudFront-Viewer-Address
headers.CloudFront-Viewer-Address
header in your origin request policy or cache policy headers configuration to forward the header to your origin.
[SUBDOMAIN].mintlify.dev
where [SUBDOMAIN]
is your project’s unique subdomain..webflow.io
.If you use Vercel, use the .vercel.app
domain available for every project.[SUBDOMAIN].mintlify.app
and another with your staging URL.
[SUBDOMAIN].mintlify.dev
./.well-known/*
/.well-known/*
and set Origin and origin groups to your docs URL.
For “Cache policy”, select CachingDisabled to ensure these verification requests pass through without caching.
.well-known/*
is too generic, it can be narrowed down to 2 behaviors at a minimum for Vercel:/.well-known/vercel/*
- Required for Vercel domain verification/.well-known/acme-challenge/*
- Required for Let’s Encrypt certificate verification/docs
/docs
with Origin and origin groups pointing to the .mintlify.dev
URL (in our case acme.mintlify.dev
).
Origin
and CloudFront-Viewer-Address
headers./docs/*
/docs/*
and Origin and origin groups pointing to the same .mintlify.dev
URL.
These settings should exactly match /docs
. With the exception of the Path pattern.
Default (*)
Default (*)
behavior.
mintlify-landing-page.vercel.app
)./docs
to the URL, you should see it going to your Mintlify documentation instance.
Alias
and then Route traffic to the Alias to CloudFront distribution
option./docs
for your primary domain.