Skip to content

Document expected delay on CNAME change and need for CAA #4487

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 10, 2018
Merged

Document expected delay on CNAME change and need for CAA #4487

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
793a3ea
Document expected delay on CNAME change
nijel Aug 7, 2018
7482484
Document CAA setup for CNAME domain SSL
nijel Aug 10, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/alternate_domains.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,13 +46,19 @@ By default, when you setup a custom domain to host documentation at Read the Doc
we will attempt to provision a domain validated SSL certificate for the domain.
This service is generously provided by Cloudflare.

If your domain has configred CAA records, please do not forget to include
Cloudflare CAA entries, see their `Certification Authority Authorization (CAA)
FAQ <https://support.cloudflare.com/hc/en-us/articles/115000310832-Certification-Authority-Authorization-CAA-FAQ>`_.

.. note::

Some older setups configured a CNAME record pointing to ``readthedocs.org``
or another variation. While these continue to resolve,
they do not yet allow us to acquire SSL certificates for those domains.
Simply point the CNAME to ``readthedocs.io``.

If you change the CNAME, the SSL certificate issuance can take about one hour.

.. important::

Due to a limitation, a domain cannot be proxied on Cloudflare
Expand Down