Skip to content

chore(site): point Pages at www.ferrosa.ai - #30

Merged
bkearns merged 1 commit into
mainfrom
chore/cutover-ferrosa-ai
Aug 24, 2026
Merged

chore(site): point Pages at www.ferrosa.ai#30
bkearns merged 1 commit into
mainfrom
chore/cutover-ferrosa-ai

Conversation

@bkearns

@bkearns bkearns commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Merging this is the cutover. GitHub reads docs/CNAME on main and reconfigures the Pages custom domain from it.

-www.ferrosadb.com
+www.ferrosa.ai

Pre-flight (verified just now)

check state
ferrosa.ai → 185.199.108-111.153 ✅ DNS-only
www.ferrosa.aiferrosadb.github.io ✅ DNS-only
MX on both domains ✅ 5 records each
DKIM on both ✅ present
www.ferrosadb.com/LATEST v0.20.0 (still live)

Grey cloud matters: GitHub validates the custom domain by seeing DNS point at it, so proxying would block certificate issuance (and caused the earlier 525).

What happens on merge

  1. Pages custom domain switches to www.ferrosa.ai.
  2. ferrosadb.com stops being a configured custom domain → GitHub 404s it.
  3. GitHub issues a Let's Encrypt cert for www.ferrosa.ai (usually minutes).

The window between 2 and 3 is the outage. This site is also the software
distribution endpoint — /LATEST (24 refs) and /install.sh (33 refs) are
compiled into installed clients — so update checks and installs fail during it.
Clients fetch with curl -fsSL, so they follow the 301 once the Cloudflare
redirect is enabled.

After merge

  1. Wait for https://www.ferrosa.ai/LATEST to return v0.20.0, and tick
    Enforce HTTPS in Settings → Pages.
  2. Only then enable the Cloudflare redirect on ferrosadb.com (that domain must
    be back to proxied/orange for the rule to run).
  3. Verify curl -sI https://ferrosadb.com/LATEST shows
    location: https://www.ferrosa.ai/LATEST — path preservation is the whole
    point; GoDaddy forwarding was ruled out because it 404s paths.

Rollback

Revert this commit and push. The cert for www.ferrosadb.com is already
issued, so the old domain comes back quickly.

Still outstanding and unrelated to this PR: the root SPF on both domains still
includes dc-aa8e722993._spfm.<domain>, which no longer resolves.

Switches the GitHub Pages custom domain from www.ferrosadb.com to
www.ferrosa.ai. Merging this IS the cutover: GitHub reads docs/CNAME on
main and reconfigures the custom domain from it.

DNS is already staged — ferrosa.ai and www.ferrosa.ai resolve to the
GitHub Pages IPs (185.199.108-111.153) DNS-only, so GitHub can validate
the domain and issue the certificate.

Expect a short window after merge: ferrosadb.com stops being a configured
custom domain and will 404 until the Cloudflare redirect rule is enabled,
and www.ferrosa.ai will not serve until GitHub issues its certificate.
The site is also the software distribution endpoint (/LATEST, /install.sh),
so that window affects installers and update checks — clients fetch with
curl -fsSL and will follow the 301 once the redirect is live.
@bkearns
bkearns merged commit 0b45f6b into main Aug 24, 2026
1 check passed
@bkearns
bkearns deleted the chore/cutover-ferrosa-ai branch August 24, 2026 21:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant