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
In your repo, open Settings › Pages, enter alice.podu.dev under Custom domain and save.
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.