Docs feedback: Add extra step for Jekyll users

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

I got stalled on this for a long time because my website is built with Jekyll and I didn't realize that the directory structure in my source does not reflect in my final build. Rather than creating new directories as listed in step 5 I needed to add a file to my root that looks like this:

---
layout: null
permalink: /.well-known/acme-challenge/Rxnv6WKo95hsuLVX3osmT6LgmzsJKSaK9htlPToohOP/index.html
---
Rxnv6WKo95hsuLVX3osmT6LgmzsJKSaK9htlPToohOP.HUGNKk82jlsmOOfphlt8Jy69iuglsn095nxOMH9j3Yb

This gets Jekyll to build the file in the right location.

Another thing that would have been very useful is providing instruction on how I could have debugged in my local environment, as so:

curl localhost:4000/.well-known/acme-challenge/Rxnv6WKo95hsuLVX3osmT6LgmzsJKSaK9htlPToohOP/index.html

I spent several hours looking through web forum discussions that talked about server configuration before realizing that I could debug and try things out from my local setup.

Many thanks to André Miranda and this wonderful tutorial, which provided the critical solution!

Edited Aug 25, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading