Instructions to setup a custom domain and email addresses similar to this one.

  1. Setup a user page on gitlab. This is very similar to github pages with the added benefit of being able to use any static site generator instead of being limited to jekyll. This will create your static website at https://<username>

  2. Buy a domain (I used namecheap). This is the only step that costs $$.

  3. Change your DNS servers to cloudflare.

  4. Create DNS records and setup TLS certificates. In my case, I setup A records for both and

  5. Setup DNSSEC. I was intermittently facing DNS resolution issues in certain regions before setting this up.

  6. To redirect all http requests to https, enable Always use HTTPS under the Crypto tab on cloudflare. Also consider enabling Automatic HTTPS Rewrites.

  7. If you’d like to redirect www requests to the non-www version, create a cloudflare page rule. In my case, I’ve setup ** to permanently redirect (HTTP 301) to$2.

  8. Setup your custom domain email addresses using Mailgun. It processes 10k messages per month for free, which is more than sufficient for my needs.

Thanks to gitlab, cloudflare and mailgun, you’ve now got your custom domain up and running with free hosting, TLS certificates and email!