Custom domain guide

How to connect a Porkbun domain to GitHub Pages

The exact records to add at Porkbun, written the way its form asks for them, for both www and the bare domain.

Checked 16 October 2026

In short

The records you'll add

Type
ALIAS - CNAME flattening
Host
leave empty
Answer

Replace the capitals with your own value from the host's dashboard.

Type
CNAME
Host
Answer

Replace the capitals with your own value from the host's dashboard.

Your user or organization name, without the repository name

Step by step

Set it up

  1. 1

    Add the domain in GitHub Pages first

    In GitHub Pages, go to Repository→Settings→Pages→Custom domain and enter your domain (for example www.example.com). With records for both www and the bare domain, GitHub Pages redirects one to the other. GitHub recommends making www the main address.

    Custom domains are free.

  2. 2

    Open the DNS records at Porkbun

    Sign in, then go to Account→Domain Management→Details→DNS Records

    The domain has to use Porkbun's nameservers.

  3. 3

    Clear what's in the way

    New domains come with parking records for the bare domain and a wildcard (*). Delete the ones on the names you're using, or Porkbun reports that a record already exists.

  4. 4

    Add the record for www

    Click Add and add:

    Type
    CNAME
    Host
    Answer

    Replace the capitals with your own value from the host's dashboard.

    Your user or organization name, without the repository name

  5. 5

    Point the bare domain

    Porkbun has an ALIAS - CNAME flattening record, which can point the bare domain at a hostname. It keeps working if GitHub Pages changes its addresses.

    Type
    ALIAS - CNAME flattening
    Host
    leave empty
    Answer

    Replace the capitals with your own value from the host's dashboard.

  6. 6

    Wait, then check

    Changes at Porkbun take effect within the hour, sometimes up to 48 hours. Once GitHub Pages sees the records, it issues the certificate for https by itself. Use the check below to see what the world sees.

Check your domain

Once the records are in, see whether the world can see them pointing at GitHub Pages.

Changes can take from a few minutes to a day to show up everywhere.

Good to know

Common snags

  • Add the domain in the repository's Pages settings before creating the records, so nobody else can claim it.
  • Never use a wildcard record (*.example.com): it lets others take over your subdomains.
  • Turn on Enforce HTTPS once it becomes available, which can take up to 24 hours.
  • Leave Host empty for the bare domain.

Still not working?

Questions

Before you start

Should I use www or the bare domain with GitHub Pages?

With records for both www and the bare domain, GitHub Pages redirects one to the other. GitHub recommends making www the main address. www always works with a single CNAME; the bare domain depends on what Porkbun offers, covered in step 5.

Why does my site show a certificate error?

The certificate is issued once GitHub Pages sees your records, which can take a while after DNS changes. If it stays, check for old records on the same name (parking pages, AAAA records) and, at Cloudflare, that the record is set to DNS only.

Will this affect my email?

No. Email uses MX records, which these steps don't touch. Only change the records for @ and www.

Rather skip git and build settings?

99helpers puts a file, a folder or a built site online in seconds, then a single CNAME connects your domain, with passwords, analytics and AI editing built in.

Connect a Porkbun domain to 99helpers

Or skip the setup

Drop it in. It's online in seconds.

A file, a folder or a whole site: 99helpers puts it online at its own address, with no git, no build settings and no DNS to start with. Add your own domain whenever you're ready.

Put it online freeWhere should I host it?