A freshly published site lives at an address like https://my-account.github.io/my-site/. Here is how to put it on a domain of your own instead.

1. Check your hosting is set up

In Site Settings, Hosting should be GitHub and Site Url should be filled in. If not, use Change Hosting next to the Hosting field and follow the steps.

Hosting configured in Site Settings

2. Open the public directory

Click Open Public Dir. Your site's published files open in a folder window. If nothing appears, change your PRSS data directory in App Settings and try again.

3. Add a CNAME file

In that folder, create a file named CNAME, with no extension, containing only your domain name.

A CNAME file containing the domain name

4. Point the domain at your site

Register the domain you wrote in the CNAME file and set up its DNS records. GitHub's guide for configuring an apex domain lists the exact records; Cloudflare works well as a registrar.

DNS records at the registrar

5. Update Site Url

Back in Site Settings, set Site Url to the full URL of that domain — prss.co in the CNAME file means https://prss.co/ here.

Site Url updated to the custom domain

6. Publish and confirm

Publish your site, then open the Publish Log and check the repository root: the CNAME file should be there. Your site appears on the new domain shortly after.

The CNAME file in the published repository
Stuck? GitHub's apex domain guide catches most setup errors, and About & Help in the PRSS sidebar reaches us directly.