Notes on moving from GitHub Pages to Codeberg Pages

When I initially set up my personal website, I started on GitHub Pages. While I don't particularly like GitHub:

• I already had an account, and know how to use it
• I was facing a bit of analysis paralysis around choosing a web host and feeling blocked

Since I just wanted to get started with, you know, actually making the site, I decided to stick with GitHub Pages initially, in order to get things up and running, with a plan to switch later.

Well...later happened, and I was incredibly pleased to find that Codeberg Pages met all of my workflow requirements, while being both a) open source and b) easy to migrate to. Since I wasn't (at the time) using a static site generator (SSG), I basically just needed to:

• Sign up for a Codeberg account
• Create a pages repo and a pages branch
• Change the remote on my local repo clone to use Codeberg instead of GitHub
• Move a few files up a level, since GitHub Pages wants everything to be in a subdirectory, while Codeberg is fine with content existing in the repo root
• Set up a repository webhook with an appropriate branch filter to cause my site to get published on "git push"

One gotcha with the last step is that (apparently) the webhook target URL needs to be set as HTTP and a delivery needs to succeed before an HTTPS URL may be used. In other words, I had to:

• Set target URL to http://sarnart.dev
• "Test Delivery" and wait for it to succeed
• Set target URL to https://sarnart.dev
• "Test Delivery again", and now the site will be available over HTTPS

Oh, and make sure you're careful when setting up the DNS entries. Typos here are sure to cause confusion. By the way, the provisioning of the SSL cert is handled entirely by Codeberg pages. In my research into this migration, I never found that this was clearly stated anywhere. Assuming you did all of the other steps correctly, Codeberg will just take care of it for you. Woohoo!

That's probably enough for now. In a future post, I'll talk about setting up eleventy (an SSG) on Codeberg pages.

Links:

Codeberg Pages
The beginnings of my humble site

---

email
home
site