GHCup
haskell.org
- Free plan
- Windows
- macOS
- Linux
- Web
- Self-hosted
What GHCup is
GHCup is a free, open-source installer and version manager for the Haskell toolchain. It installs and manages versions of GHC, cabal-install, Haskell Language Server (HLS), and Stack; Stack can also be configured to use GHC versions managed by GHCup. Listed functionality includes a terminal user interface and GHC cross-compilation. Installation guidance covers terminal instructions for Linux, macOS, FreeBSD, and WSL2, plus PowerShell instructions for Windows. On Unix-like systems, the installer should be run as a non-root user, and Windows users should use a non-admin account. macOS may prompt for command line tools, while Windows installation includes setting up msys2. Configuration can be placed in ~/.ghcup/config.yaml, with command-line options taking precedence. GHCup relies on precompiled binaries, so compatibility depends on Linux distributions compatible with upstream GHC binaries and may be affected by missing libraries such as libtinfo. The project describes Windows support as early stage. WSL1 and macOS versions earlier than 10.13 are unsupported, and some ARM binaries are experimental.
Who it suits
GHCup suits Haskell developers who want to install and manage versions of the Haskell compiler and related tools. Users should check its operating-system limits and experimental ARM support before choosing an installation path.
Good to know, and what to watch
- Manages GHC, cabal-install, HLS, and Stack
- Stack can use GHCup-managed GHC versions
- Includes a terminal user interface
- Supports GHC cross-compilation
- Free and open source
- WSL1 is unsupported
- macOS earlier than 10.13 is unsupported
- Windows support is described as early stage
- Some ARM binaries are experimental
Plans
Every plan and priceGHCup
Open source
Getting started
- Open the GHCup website
- Follow terminal instructions for Linux, macOS, FreeBSD, or WSL2
- Use the PowerShell instructions on Windows
- Run the installer as a non-root or non-admin user
- Set up macOS command line tools or Windows msys2 when prompted
- Store optional settings in ~/.ghcup/config.yaml
Limits to check
WSL1 and macOS releases earlier than 10.13 are outside the stated support. Linux ARM Stack and HLS binaries and macOS aarch64 HLS bindists are experimental; precompiled binaries can also encounter distribution or library compatibility problems.
The Club's review
Overview
GHCup brings Haskell’s core compiler and development tools into one version manager, with command-line setup for a range of systems. It is a strong fit for developers maintaining a Haskell toolchain across machines or in CI, provided their operating system and processor have dependable binary support.
Its concentrated scope makes it useful for Haskell work, while the lack of automatic project-level version selection and uneven support on Windows and ARM narrow its appeal for some setups.
Key features
GHCup installs and manages GHC, cabal-install, Haskell Language Server (HLS) and Stack versions. Keeping these components under one manager can simplify toolchain maintenance; Stack can also be configured to use GHC versions installed by GHCup. Shell integration and CI/CD usage extend that utility to scripts and build environments.
The FAQ includes a text-based interface and GHC cross-compilation among GHCup’s functions. Users can put configuration in ~/.ghcup/config.yaml, and command-line options take precedence. GHCup does not pin versions per project or switch them automatically, so developers working across projects that require different versions must handle that selection themselves.
Setup uses terminal instructions on Linux, macOS, FreeBSD and WSL2, and PowerShell instructions on Windows. On Unix-like systems, the installer should run as a non-root user; on Windows, use a non-admin account. macOS may prompt for command line tools, and Windows setup should configure msys2.
Pricing
GHCup is open source and free. Its GHCup plan costs nothing and covers Haskell toolchain installation and management. There is no free trial and no paid tier to upgrade to; the supplied plan has no stated seat or usage quota.
Platforms
GHCup’s platform scope includes Linux, macOS, Windows, web and self-hosted environments, while installation instructions specifically cover Linux, macOS, FreeBSD, WSL2 and Windows. Linux support depends on compatibility with upstream GHC binaries. Since GHCup relies on precompiled binaries, missing libtinfo or other distribution compatibility issues can interrupt setup.
Windows support is described as early-stage. A shim wrapper works around Windows’ limited symbolic-link support, and msys2 is part of installation. WSL1 is unsupported. macOS versions earlier than 10.13 are unsupported; HLS binaries on macOS ARM and Stack and HLS binaries on Linux ARM are experimental. Those constraints make the target OS and architecture important checks before adopting it.
Who it's for
GHCup suits Haskell developers who want one installer to manage the compiler, package tooling, language server and Stack, including those using shell integration or CI/CD. It is less suitable for teams that require automatic per-project switching, or for users whose Windows or ARM setup depends on components marked experimental.
Pros and cons
- Pros: One manager covers GHC, cabal-install, HLS and Stack versions, reducing the number of separate tools needed for a Haskell setup.
- Pros: Stack can use GHCup-managed GHC versions, and shell integration and CI/CD support make the tool relevant beyond local setup.
- Pros: Free, open-source access makes the full toolchain manager available without a paid plan.
- Cons: No project version pinning or automatic switching means users must manage version selection themselves across projects.
- Cons: Windows support is early-stage, WSL1 is unsupported, and several ARM binaries are experimental.
- Cons: Precompiled binaries can hit distribution compatibility problems, including missing libtinfo.
Alternatives
For Java version management, Jabba is a free option for Linux, macOS and Windows. For Go, GVM is free on Linux and macOS. Perl users on those systems can consider plenv, while chruby is a free Ruby option that requires bash 3 or later, or zsh.
For Node.js, nvm is a free, open-source version manager covering Linux, macOS, self-hosted and Windows environments. rustup is a free choice for Rust on Linux, macOS and Windows, while elan provides free Lean version management on those systems. axe-playwright is a free MIT-licensed option for Linux and web environments with a Playwright peer dependency.
For broader tool discovery, browse Runtime Version Managers or Development Environment Managers.
Verdict
Choose GHCup if you need a free, focused way to install and manage Haskell’s main tools, especially across shell and CI environments. Its unified toolchain coverage is the main draw. Look elsewhere or plan extra version management if automatic project switching is essential, and check compatibility carefully for Windows, ARM and Linux distributions before relying on it.
The verdict
GHCup brings several Haskell tools and their versions under one installer, with guidance for multiple operating systems. Compatibility constraints, especially on Windows and ARM, are worth checking before installation.
Questions people ask
How much does GHCup cost?
GHCup is free and open source. Its listed GHCup plan is free.
Which tools does it manage?
It manages GHC, cabal-install, Haskell Language Server, and Stack versions.
Which platforms are supported?
The listed platforms are Linux, macOS, Windows, self-hosted, and web. Installation guidance covers Linux, macOS, FreeBSD, WSL2, and Windows PowerShell.
Can Stack use GHCup versions?
Yes. Stack can be configured to use GHC versions installed and managed by GHCup.
Is there a free trial?
No. The facts list no free trial, but the product itself is free.
What the maker publishes
- Binary limitations
- GHCup uses precompiled binaries, which can encounter missing libtinfo or other distribution compatibility problems. source
- Configuration
- GHCup configuration can be placed in ~/.ghcup/config.yaml, and command-line options override configuration file settings. source
- Cross compilation
- The FAQ lists GHC cross-compilation among GHCup's functionality. source
- Experimental support
- The site describes HLS bindists on macOS aarch64 as experimental and Stack and HLS binaries on Linux ARM as experimental. source
- Help
- The homepage directs users to troubleshooting, IRC, Discord, or bug reporting for help. source
- Help
- The project directs users to troubleshooting, IRC, Discord, or its bug reporting page for help. source
- Installation
- The site provides terminal installation instructions for Linux, macOS, FreeBSD, and WSL2, and PowerShell instructions for Windows. source
- Installation requirements
- On macOS, running GHCup may prompt the user to install command line tools; on Windows, msys2 should be set up during installation. source
- Linux distribution support
- The project says it supports GNU/Linux distributions compatible with upstream GHC binaries. source
- Maintainer
- The team page names Julian Ospald as GHCup's author and maintainer. source
- Maintainer
- The team page lists Julian Ospald as GHCup's author and maintainer. source
- Managed tools
- GHCup supports GHC, cabal-install, Haskell Language Server (HLS), and Stack. source
- Platforms
- The supported platform list includes Windows, macOS, FreeBSD, and generic Linux, with support varying by tool and architecture. source
- Platforms
- The supported platforms list includes Windows, macOS, FreeBSD, Linux, and Windows WSL2; support varies by tool and architecture. source
- Purpose
- GHCup is the main installer for the general purpose language Haskell. source
- Purpose
- GHCup is the main installer for the general purpose language Haskell. source
- Security
- The installation instructions say to run the installer as a non-root user on Unix-like systems and a non-admin user on Windows. source
- Security
- The installation instructions use HTTPS with TLS 1.2 or later for the Linux, macOS, FreeBSD, and WSL2 bootstrap command. source
- Stack integration
- Stack can be configured to use GHC versions installed and managed by GHCup. source
- Stack integration
- Stack can be configured to use GHC versions installed and managed by GHCup through a hook or the system GHC on PATH. source
- Stack integration caveat
- When Stack setup-info metadata is used, GHCup warns that compatible HLS binaries are not guaranteed and latest or recommended shortcuts do not work. source
- Support limits
- The site says WSL1 is unsupported and macOS versions earlier than 10.13 are not supported. source
- Toolchain
- GHCup supports GHC, cabal-install, HLS, and Stack versions. source
- User interface
- The FAQ lists a TUI among GHCup's functionality. source
Checked against the maker's pages on 9 Oct 2026.