Using the .well-known/ folder on a GitHub Pages hosted Jekyll site

Published: December 14, 2018


Recently I registered this site for Brave Rewards.

There were two options for doing this:

  1. Upload a file to the .well-known/ directory on the website
  2. Create a DNS record

I decided to opt for the former.

Initially, I thought it was as simple commiting the file to the repo in the specified location. However, after pushing and letting the site build I got a 404 when attempting to access

Some quick Googling lead me to keybase/keybase-issues GitHub issue #366.

After scrolling thourgh the comments I saw the following suggestion:

With Jekyll on GitHub Pages just add a file keybase.txt in your root and add the following header:

layout: none
permalink: .well-known/foo.txt

I made the update and pushed again. I then reloaded the page and saw expected response. Mission accomplished :boom:

Max Chadwick Hi, I'm Max!

I'm a software developer who mainly works in PHP, but also dabbles in Ruby and Go. Technical topics that interest me are monitoring, security and performance.

During the day I solve challenging technical problems at Something Digital where I mainly work with the Magento platform. I also blog about tech, work on open source and hunt for bugs.

If you'd like to get in touch with me the best way is on Twitter.