sandstorm-io/sandstorm

Add to Docs: WordPress/HackerCMS/Hugo etc can host root domain example.com with CNAME flattening or ANAME records

Open

#3611 opened on Mar 7, 2022

View on GitHub
 (1 comment) (0 reactions) (0 assignees)JavaScript (6,583 stars) (737 forks)batch import
documentationgood first issue

Description

Request to add to Docs: WordPress/HackerCMS/Hugo etc can host root domain example.com

  1. CNAME flattening at CloudFlare:

https://blog.cloudflare.com/introducing-cname-flattening-rfc-compliant-cnames-at-a-domains-root/

  1. ANAME records by dnsmadeeasy:

https://dnsmadeeasy.com/services/anamerecords

  1. DDNS:

https://www.ddns.com.au/index.php?rp=/knowledgebase/239/CNAME-Flattening.html

  1. Maybe AWS Route53 alias records:

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-choosing-alias-non-alias.html

(there could be other similar services)

Howto: root domain

CNAME: example.com Content: abcde123.something.sandcats.io

TXT name: sandstorm-www.example.com TXT Content: abcde123

Howto: www subdomain, or other subdomain

CNAME: www.example.com Content: abcde123.something.sandcats.io

TXT name: sandstorm-www.www.example.com TXT Content: abcde123

Contributor guide

Tech stack
None
Domain
documentationinfrastructure
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
understanding of DNSknowledge of CNAME and TXT records
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70
Research direction
Review the provided links on CNAME flattening, ANAME records, DDNS, and AWS Route53 alias records. Examine Sandstorm's existing documentation for domain configuration (e.g., in docs/ directory). Compile a step by step guide for hosting root domains using these methods, ensuring compatibility with Sandstorm's sandcats.io dynamic DNS. Reference the current TXT record setup explained in the issue.