Upgrading Hugo
Upgrading Hugo from old to new
So my Hugo version on this site is currently v0.122.0 and with v0.145.0 released last month I thought it was time to upgrade and get back to the current release.
First step, check how Hugo is installed
❯ hugo version
hugo v0.122.0-b9a03bd59d5f71a529acb3e33f995e0ef332b3aa+extended darwin/arm64 BuildDate=2024-01-26T15:54:24Z VendorInfo=brew
We can see that we used Hugo extended and that Hugo was installed via Homebrew so that’s the method to use to upgrade. First, update Homebrew:
❯ brew update
==> Downloading
I want to upgrade Hugo to the next release. For me that is v0.123.0.
Unfortunately, Homebrew only has the latest stable version to choose from:
❯ brew search hugo
==> Formulae
hugo ✔
Meaning we need to uninstall Hugo from Homebrew and then install from the release:
❯ brew uninstall hugo
Uninstalling /opt/homebrew/Cellar/hugo/0.122.0... (50 files, 83.1MB)
Now to download the next version which we mentioned above was v0.123.0 and specifically, as we’re running MacOS and we were previously using the Hugo extended version, we’ll download hugo_extended_0.123.0_darwin-universal.tar.gz and extract it to your bin directory
❯ wget https://github.com/gohugoio/hugo/releases/download/v0.123.0/hugo_extended_0.123.0_darwin-universal.tar.gz
❯ tar -xvzf ~/Downloads/hugo_extended_0.123.0_darwin-universal.tar.gz
x hugo
x README.md
x LICENSE
Then check the Hugo version:
❯ hugo version
hugo v0.123.0-3c8a4713908e48e6523f058ca126710397aa4ed5+extended darwin/arm64 BuildDate=2024-02-19T16:32:38Z VendorInfo=gohugoio
Finally, test the local server, upgrade any pinned GitHub Actions Hugo Versions, and push to production.
Then just repeat the process for each new release until you get to the latest, v0.145.0. I noted that another version was available now, Hugo Extended with Deploy, which comes with some cool advanced features like WebP encoding, Sass transpiling, and the ability to deploy directly to cloud storage services like Amazon S3, Azure Blob Storage, or Google Cloud Storage using the hugo deploy command which I was doing via Makefile previously so this might be able to take that over.
❯ hugo version
hugo v0.145.0-666444f0a52132f9fec9f71cf25b441cc6a4f355+extended+withdeploy darwin/arm64 BuildDate=2025-02-26T15:41:25Z VendorInfo=gohugoio