Hero Image
Hugo's module.mounts quietly replaced my static directory

This site had a bug that survived several deploys unnoticed: the whole site worked, except that the OpenGraph card, the image that link previews show when you paste a URL into WhatsApp or LinkedIn, returned 404 in production. Browsers never load that file when you visit a page, so nothing looked broken. Every build was green. The file was in the repository. And the URL was dead. If you want the ending first: declaring any entry under module.mounts for a target root replaces Hugo’s default mount for that root. I had mounted one subfolder of static, and in doing so had silently unmounted everything else in it.

Thursday, July 23, 2026 | 3 minutes Read
Hero Image
Installing Hugo on WSL

If you develop on Windows but want a Linux toolchain, Hugo runs happily under WSL. Here is the quick version, plus the one gotcha worth knowing. The quick way (often out of date) Update your package list and install from apt: sudo apt update sudo apt install hugo This works, but Ubuntu and Debian package a version of Hugo that usually lags well behind the current release. Themes move quickly, and plenty of them need a newer Hugo than apt will give you. If a theme’s build complains about your Hugo version, this is why.

Wednesday, January 22, 2025 | 1 minute Read