How to Create GitHub Pages for GitHub Enterprise Accounts

Turns out, it’s not as simple as github.io anymore

Jason Jung
2 min readApr 20, 2019

TL;DR

To host on GitHub Pages using an enterprise account, create a repository using the following format:

<username or orgname>.github.secureserver.net

For example, for me the repository name would look like jasonjung.github.secureserver.net, where jasonjung is my username and github.secureserver.net is the hostname (your hostname might be different).

For an individual account, it would simply look like the following:

<username or orgname>.github.io

Source: https://pages.github.com.

GitHub Pages for Enterprise

Welcome to my first short tutorial series! Here, I want to write shorter tutorials on what I think might be helpful for others who are trying to solve the same issue. When I tried to search this exact issue, I couldn’t find one. So when someone else tries to google this problem, hopefully this article will show.

Recently, I struggled creating a simple github.io website using Github Enterprise account. I have been using GitHub Pages for a while to host my personal website (jasjung.github.io) and Jekyll to write blog posts. I wanted to do the same at work but I was stuck because I wasn’t aware of the differences in the enterprise account.

Initially, I tried to create a repository named [my_work_username].github.io. When I deployed Jekyll on it, all the links were broken and CSS weren’t rendering correctly. I initially thought my _config.yml file wasn’t configured correctly. But after some web searching, I ran across this documentation and learned that I wasn’t naming my repo correctly! For the correct method, please refer to TL;DR section above.

And thus concludes my short tutorial. Thank you for reading and hope this helps!

--

--

Jason Jung

SWE/Data Scientist @ Shopify. Alum @ Northwestern and @ UCLA. Creator @ https://salary.ninja. Visit me @ https://jasjung.github.io