Pointing Your Apex Domain to GitHub Pages
Table of Contents
- Using the One-click Service
- Adding an ALIAS record
- Setting up your custom domain with GitHub
- Have more questions?
Your domain apex is the second or third level domain provided to you by your domain registrar. For example, dnsimple.com is the root domain for DNSimple.
To point your root domain to your GitHub Pages you have two options:
- Use the One-click Service that DNSimple provides.
- Manually add an ALIAS record.
Using the One-click Service
- From the domain list, click on the domain name you want to update.
- Click the DNS tab on the left side.
-
Scroll down to the One-click services card, and click Add.
- Select the Hosting tab, and scroll down the page until you find the GitHub Pages service. Click Add.
The service has been added. You can remove it any time by following the steps in how to remove a service.
Adding an ALIAS record
Go to the advanced editor page for your domain to manage your DNS records. Click Add a Record, and select the ALIAS
record type.
Enter the following settings:
-
Name: leave this blank (we want to create an
ALIAS
for the apex domain). - Alias for: enter your GitHub Pages endpoint.
Now, complete the setup of your domain in your GitHub repo.
Setting up your custom domain with GitHub
Read GitHub’s guide on how to setup a custom domain with GitHub Pages, and complete the required steps to ensure your domain works correctly.
Even if you are only pointing your domain apex to GitHub Pages using an ALIAS
record, you will need to add the custom domain to GitHub pages.
Have more questions?
If you have additional questions or need any assistance with our One-click Services, just contact support, and we’ll be happy to help.