Skip to content
Supported platforms

Supported platforms

A subset of the platforms supported by Hugo itself are supported by these wheels for hugo via hugo-python-distributions. The plan is to support as many platforms as possible with Python wheels and platform tags. Please refer to the following table for a list of supported platforms and architectures:

PlatformArchitectureSupport
macOSx86_64 (Intel)✅ macOS 13.0 (Ventura) and later
macOSarm64 (Silicon)✅ macOS 13.0 (Ventura) and later
Linuxamd64✅ glibc 2.17 and later
Linuxarm64✅ glibc 2.17 and later
Linuxs390x✅ glibc 2.17 and later
Linuxppc64le✅ glibc 2.17 and later
Linuxarmv6l✅ via piwheels 1
Linuxarmv7l✅ via piwheels 1
Windowsx86_64✅
Windowsarm64✅
Windowsx86✅ 2
DragonFlyBSDamd64❌ Will not receive support3
FreeBSDamd64❌ Will not receive support3
OpenBSDamd64❌ Will not receive support3
NetBSDamd64❌ Will not receive support3
Solarisamd64❌ Will not receive support3

For instructions on building Hugo for a specific platform or architecture, including cross-compilation, see Building from sources.


  1. Wheels for Raspberry Pi (ARMv6l and ARMv7l) are built and distributed by piwheels, a community service that provides pre-compiled Python wheels for Raspberry Pi devices. These are not published to PyPI and are only available via the piwheels index. To install, add --extra-index-url https://www.piwheels.org/simple to your pip install command, or configure it permanently in your pip.conf. Raspberry Pi OS includes this index by default. ↩︎ ↩︎

  2. The 32-bit (i686) wheels for Windows are cross-compiled with the Go toolchain from 64-bit runners, and the resulting binaries are tested in CI through the WoW64 compatibility layer. This target is not officially supported by the Hugo project, which does not publish 32-bit Windows binaries. Please refer to the Building from source section for more information on how to build Hugo for other platforms and architectures locally. If you need official support for a platform or face any bugs, please consider contacting the Hugo authors by opening an issue. ↩︎

  3. Support for these platforms is not possible to include because of i. the lack of resources to test and build for them and ii. the lack of support for these platform specifications in Python packaging standards and tooling. If you need support for these platforms, please consider downloading the official Hugo binaries for these platforms. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎