We recommend you download and use Stack instead of using MinGHC - it's what all the MinGHC authors do. The MinGHC approach to installing both GHC and MSYS has been adopted by Stack and Stack provides some additional benefits:
- Easier to upgrade to newer GHC versions
- Support for working with multiple GHC versions without switching environments
- Simple upgrade procedure for Stack itself
- Isolated environment that avoids contaminating your
PATHvariable
For more information on using Stack, please read the Stack guide.
One note: when using Stack, you need to make a few changes to how you call some tools outside of a project:
stack ghc -- ...to compile filesstack runghc -- ...to interpret filesstack exec -- ...to run arbitrary commands
This project provides a Windows installer with:
- GHC, so you can write Haskell code.
- Stack, a modern build tool for Haskell.
- MSYS, so packages with configure scripts (notably network) compile.
- Cabal, an older but still commonly used Haskell build tool.
It does not provide all the packages included with the Haskell Platform, but it does provide an environment where you can install those packages. Some require installing c libraries.
- Download installer with GHC 7.10.2 (32-bit)
- Download installer with GHC 7.10.2 (64-bit)
- Download installer with GHC 7.8.4 (32-bit)
- Download installer with GHC 7.8.4 (64-bit)
You may wish to also check the Github latest releases page.
To use MinGHC, download and run the installer. There are two options you may wish to modify:
- "Add programs to PATH" - select this if you want to make this version of GHC the standard one you use for general development. It will modify your
%PATH%environment variable so the MinGHC installed copies ofghcandcabalare used by default. - "Add switcher to PATH" - select this if you want to use a different GHC normally, but occasionally switch to this version. After installation, type
minghc-7.8.3at a command prompt to temporarily add the MinGHC copies ofghcandcabal.
Caveats:
- The
networklibrary doesn't work well with Cygwin. Hence, it is not recommended that you usecabal installin a Cygwin terminal. Use Command Prompt (cmd.exe) or Windows PowerShell instead.
Before stack, there were two ways to get GHC on Windows, straight from the GHC distribution and using the Haskell Platform. The GHC distribution is hard to unpack (.xv files are not Windows friendly), doesn't setup the %PATH%, lacks Cabal and cannot build the network library on its own. The Haskell Platform is easy to install and comes with more libraries, but still won't build the network library and usually lags the GHC release by months. This installer is the GHC distribution with all the issues above fixed.
Users of MinGHC installers do not need to build it themselves. Below are instructions for anyone who wants to contribute to future installers.
You need NSIS installed:
- Download NSIS 3.0b2, install it, and place the installation directory on your
PATH. - Patch NSIS with the large strings build for 3.0b2 found among its special builds. (The patch is applied by copying the files in the patch archive over top the NSIS installation.)
Creating installers requires a two-step process: 1) build the installer-generation script and then 2) run the script to create installers.
- To build the installer-generation script, run
stack build. - To execute the installer generator, run
stack exec minghc-generate.
By default, the installer generator will create an installer for the most recent GHC release (32-bit).
You can build installers for other official releases by providing a version number and possibly --arch64 to use 64-bit
GHC.
For example, the following will build an older release as 64-bit.
> stack exec minghc-generate -- 7.8.4 --arch64
The resulting installer can be found in the .build directory.