Skip to content

Support details

Supported tools

GHCup supports the following tools, which are also known as the Haskell Toolchain:

Show all supported GHC versions
GHC VersionTags
9.14.1latest, base-4.22.0.0
9.12.4base-4.21.2.0
9.12.2base-4.21.0.0
9.12.1base-4.21.0.0
9.10.3base-4.20.1.0
9.10.2base-4.20.1.0
9.10.1base-4.20.0.0
9.8.4base-4.19.2.0
9.8.2base-4.19.1.0
9.8.1base-4.19.0.0
9.6.7recommended, base-4.18.3.0
9.6.6base-4.18.2.1
9.6.5base-4.18.2.1
9.6.4base-4.18.2.0
9.6.3base-4.18.1.0
9.6.2base-4.18.0.0
9.6.1base-4.18.0.0
9.4.8base-4.17.2.1
9.4.7base-4.17.2.0
9.4.6base-4.17.2.0
9.4.5base-4.17.1.0
9.4.4base-4.17.0.0
9.4.3base-4.17.0.0
9.4.2base-4.17.0.0
9.4.1base-4.17.0.0
9.2.8base-4.16.4.0
9.2.7base-4.16.4.0
9.2.6base-4.16.4.0
9.2.5base-4.16.4.0
9.2.4base-4.16.3.0
9.2.3base-4.16.2.0
9.2.2base-4.16.1.0
9.2.1base-4.16.0.0
9.0.2base-4.15.1.0
9.0.1base-4.15.0.0
8.10.7base-4.14.3.0
8.10.6base-4.14.3.0
8.10.5base-4.14.2.0
8.10.4base-4.14.1.0
8.10.3base-4.14.1.0
8.10.2base-4.14.1.0
8.10.1base-4.14.0.0
8.8.4base-4.13.0.0
8.8.3base-4.13.0.0
8.8.2base-4.13.0.0
8.8.1base-4.13.0.0
8.6.5base-4.12.0.0
8.6.4base-4.12.0.0
8.6.3base-4.12.0.0
8.6.2base-4.12.0.0
8.6.1base-4.12.0.0
8.4.4base-4.11.1.0
8.4.3base-4.11.1.0
8.4.2base-4.11.1.0
8.4.1base-4.11.0.0
8.2.2base-4.10.1.0
8.0.2base-4.9.1.0
7.10.3base-4.8.2.0
Show all supported cabal-install versions
Cabal VersionTags
3.16.1.0latest
3.16.0.0
3.14.2.0recommended
3.14.1.1-p1
3.14.1.1
3.14.1.0
3.12.1.0
3.10.3.0
3.10.2.1
3.10.2.0
3.10.1.0
3.8.1.0
3.6.2.0-p1
3.6.2.0
3.6.0.0
3.4.1.0
3.4.0.0
3.2.0.0
3.0.0.0
2.4.1.0
Show all supported HLS versions
HLS VersionTags
2.13.0.0latest, recommended
2.12.0.0
2.11.0.0
2.10.0.0
2.9.0.1
2.9.0.0
2.8.0.0
2.7.0.0
2.6.0.0
2.5.0.0
2.4.0.0
2.3.0.0
2.2.0.0
2.1.0.0
2.0.0.1
2.0.0.0
1.10.0.0
1.9.1.0
1.9.0.0
1.8.0.0
1.7.0.0
1.6.1.0
1.6.0.0
1.5.1
1.5.0
1.4.0
1.3.0
1.2.0
1.1.0
Show all supported Stack versions
Stack VersionTags
3.9.1latest
3.7.1recommended
3.5.1
3.3.1
3.1.1
2.15.7
2.15.5
2.15.3
2.15.1
2.13.1
2.11.1
2.9.3
2.9.1
2.7.5
2.7.3
2.7.1
2.5.1

Supported platforms

This list may not be exhaustive and specifies support for bindists only.

Platform Architecture ghcup GHC cabal HLS stack
Windows 8.1 amd64 ✅ ✅ ✅ ✅ ✅
Windows 10 amd64 ✅ ✅ ✅ ✅ ✅
Windows Server 2016 amd64 ✅ ✅ ✅ ✅ ✅
Windows Server 2019 amd64 ✅ ✅ ✅ ✅ ✅
Windows Server 2022 amd64 ✅ ✅ ✅ ✅ ✅
Windows WSL1 amd64 ❌ ❔ ❔ ❔ ❔
Windows WSL2 amd64 ✅ ✅ ✅ ✅ ✅
MacOS >=10.13 amd64 ✅ ✅ ✅ ✅ ✅
MacOS <10.13 amd64 ❌ ❔ ❔ ❔ ❔
MacOS aarch64 ✅ ✅ ✅ ⚠️ ❌
FreeBSD amd64 ✅ ⚠️ ✅ ⚠️ ❌
Linux generic x86 ✅ ✅ ✅ ✅ ✅
Linux generic amd64 ✅ ✅ ✅ ✅ ✅
Linux generic aarch64 ✅ ⚠️ ✅ ⚠️ ❌
Linux generic armv7 ✅ ⚠️ ✅ ⚠️ ❌

Windows <8.1

No longer supported for recent GHCs, according to manual testing of GHC 9.8.1 on Windows 7. According to msys2 documentation, the minimum Windows version is now 8.1.

WSL1

Unsupported. GHC may or may not work. Upgrade to WSL2.

MacOS <10.13

Not supported. Would require separate binaries, since >=10.13 binaries are incompatible. Please upgrade.

MacOS aarch64

HLS bindists are still experimental. Stack has only unofficial binaries for this platform. There are various issues with GHC itself.

FreeBSD

Lacks some upstream bindists and may need compat libs (such as misc/compat12x). HLS bindists are experimental. Only latest FreeBSD is generally supported.

Linux ARMv7/AARCH64

Lower availability of bindists. Stack and HLS binaries are experimental.

Esoteric distros

Void Linux

Since void linux can be installed with glibc and musl, it's hard to support correctly with ghcup. One way to make ghcup work on Void Linux musl is to follow the Overriding distro detection section and tell it to consider Alpine bindists only. E.g.:

curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | BOOTSTRAP_HASKELL_MINIMAL=1 sh
source ~/.ghcup/env
ghcup config set platform-override '{ "arch": "A_64", "platform": { "contents": "Alpine", "tag": "Linux" }, "version": "3.17" }'
ghcup install cabal --set latest
ghcup install ghc --set latest
ghcup install stack --set latest
ghcup install hls --set latest