Point your pod at GitHub Pages

GitHub Pages needs the custom domain set in your repo and a CNAME pointing at your Pages address.

At GitHub Pages first

  1. In your repo, open Settings › Pages, enter alice.podu.dev under Custom domain and save.

  2. Optional, protects against takeover: in your profile Settings › Pages, choose Add a domain. GitHub shows a TXT record named like _github-pages-challenge-alice.

In Podu

Pick GitHub Pages on the claim page and use username.github.io, without the repository name. Tick the TXT box if you started verification. We create:

alice.podu.dev   CNAME   alice.github.io
; optional
_github-pages-challenge-alice.alice.podu.dev   TXT   "abc123example"

HTTPS

Tick Enforce HTTPS in Settings › Pages. It can take up to 24 hours before the option is available.

More on certificates: HTTPS for your pod.

It doesn't work?

  • The CNAME points at alice.github.io/repo: drop the repository part.
  • Enforce HTTPS is greyed out: wait for GitHub to issue the certificate.
  • The custom domain field is empty after a deploy from a workflow: set it again in Settings › Pages.
  • Still stuck? Open an issue on GitHub.