stack: The Haskell Tool Stack

[ bsd3, development, library, program ] [ Propose Tags ]

Please see the for usage information, and the wiki on Github for more details. Also, note that the API for the library is not currently stable, and may change significantly, even between minor releases. It is currently only intended for use by the executable.

[Skip to Readme]
Versions 0.0.0, 0.0.1, 0.0.2,, 0.0.3,,,,,,,,,,,,, 1.0.0, 1.0.2, 1.0.4,,,, 1.1.0, 1.1.2, 1.2.0, 1.3.0, 1.3.2, 1.4.0, 1.5.0, 1.5.1, 1.6.1,, 1.6.3,, 1.6.5, 1.7.1, 1.9.1,, 1.9.3, 9.9.9 (info)
Change log
Dependencies aeson (>=, async (>=2.0.2), attoparsec (>=, base (>=4.7 && <5), base16-bytestring, base64-bytestring, bifunctors (>=4.2.1), binary (>=0.7), blaze-builder, byteable, bytestring (>=, Cabal (>=, conduit (>=1.2.4), conduit-combinators (>=0.3.1), conduit-extra (>=, containers (>=, cryptohash (>=0.11.6), cryptohash-conduit, deepseq, deepseq-generics, directory (>=, either, enclosed-exceptions, exceptions (>=, extra, fast-logger (>=2.3.1), file-embed, filelock (>=, filepath (>=, fsnotify (>=0.2.1), gitrev (>=1.1), hashable (>=, hastache, http-client (>=0.4.17), http-client-tls (>=0.2.2), http-conduit (>=2.1.7), http-types (>=0.8.6), ignore (>=0.1.1), lifted-base, monad-control, monad-logger (>=, monad-loops (>=, mtl (>=, old-locale (>=, optparse-applicative (>=, optparse-simple (>=0.0.3), path (>=0.5.1), persistent (>=2.1.2), persistent-sqlite (>=2.1.4), persistent-template (>=2.1.1), pretty, process (>=, project-template (>=0.2), resourcet (>=, retry (==0.6.*), safe (>=0.3), split, stack, stm (>=2.4.4), streaming-commons (>=, tar (>=, template-haskell, temporary (>=, text (>=, time (>=1.4.2), transformers (>=, transformers-base (>=0.4.4), unix (>=, unix-compat, unordered-containers (>=, vector (>=, vector-binary-instances, void (>=0.7), Win32, word8, yaml (>=, zlib (>= [details]
License BSD-3-Clause
Author Chris Done
Revised Revision 1 made by borsboom at Mon Nov 30 12:57:22 UTC 2015
Category Development
Home page
Source repo head: git clone
Uploaded by borsboom at Fri Sep 4 06:25:36 UTC 2015
Distributions Arch:1.9.3, Debian:1.7.1, LTSHaskell:1.7.1, NixOS:1.9.3, Stackage:1.9.3, openSUSE:1.9.3
Executables stack
Downloads 25299 total (291 in the last 30 days)
Rating 2.0 (votes: 5) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2015-10-19 [all 5 reports]
Hackage Matrix CI


  • Data
    • Attoparsec
      • Data.Attoparsec.Args
  • Network
    • HTTP
      • Download
        • Network.HTTP.Download.Verified
  • Options
    • Applicative
      • Options.Applicative.Args
      • Builder
        • Options.Applicative.Builder.Extra
  • Path
    • Path.IO
  • Stack
    • Stack.Build
      • Stack.Build.Cache
      • Stack.Build.ConstructPlan
      • Stack.Build.Coverage
      • Stack.Build.Execute
      • Stack.Build.Haddock
      • Stack.Build.Installed
      • Stack.Build.Source
      • Stack.Build.Target
    • Stack.BuildPlan
    • Stack.Config
    • Stack.Constants
    • Stack.Docker
      • Stack.Docker.GlobalDB
    • Stack.Dot
    • Stack.Exec
    • Stack.Fetch
    • Stack.FileWatch
    • Stack.GhcPkg
    • Stack.Ghci
    • Stack.Ide
    • Stack.Image
    • Stack.Init
    • Stack.New
    • Stack.Options
    • Stack.Package
    • Stack.PackageDump
    • Stack.PackageIndex
    • Stack.SDist
    • Stack.Setup
    • Stack.Solver
    • Stack.Types
      • Stack.Types.Build
      • Stack.Types.BuildPlan
      • Stack.Types.Compiler
      • Stack.Types.Config
      • Stack.Types.Docker
      • Stack.Types.FlagName
      • Stack.Types.GhcPkgId
      • Stack.Types.Image
      • Stack.Types.Internal
      • Stack.Types.Package
      • Stack.Types.PackageIdentifier
      • Stack.Types.PackageName
      • Stack.Types.StackT
      • Stack.Types.TemplateName
      • Stack.Types.Version
    • Stack.Upgrade
    • Stack.Upload
  • System
    • Process
      • System.Process.Log
      • System.Process.Read
      • System.Process.Run



Run the integration test suite


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees

Readme for stack-

[back to package description]

The Haskell Tool Stack

Build Status Release

stack is a cross-platform program for developing Haskell projects. It is aimed at Haskellers both new and experienced.

<img src="" width="50%" align="right">

It features:

  • Installing GHC automatically, in an isolated location.
  • Installing packages needed for your project.
  • Building your project.
  • Testing your project.
  • Benchmarking your project.

How to install

Downloads are available by operating system:

Upgrade instructions

Note: if you are using cabal-install to install stack, you may need to pass a constraint to work around a Cabal issue: cabal install --constraint 'mono-traversable >= 0.9' stack.

How to use

Go into a Haskell project directory and run stack build. If everything is already configured, this will:

  • Download the package index.
  • Download and install all necessary dependencies for the project.
  • Build and install the project.

You may be prompted to run some of the following along the way:

  • stack new to create a brand new project.
  • stack init to create a stack configuration file for an existing project. stack will figure out what Stackage release (LTS or nightly) is appropriate for the dependencies.
  • stack setup to download and install the correct GHC version in an isolated location that won't interfere with any system-level installations. (For information on installation paths, please use the stack path command.)

If you just want to install an executable using stack, then all you have to do is stack install <package-name>.

Run stack for a complete list of commands.

Complete guide to stack

This repository also contains a complete guide to using stack, covering all of the most common use cases.

Questions, Feedback, Discussion

Why stack?

stack is a project of the Commercial Haskell group, spearheaded by FP Complete. It is designed to answer the needs of commercial Haskell users, hobbyist Haskellers, and individuals and companies thinking about starting to use Haskell. It is intended to be easy to use for newcomers, while providing the customizability and power experienced developers need.

While stack itself has been around since June of 2015, it is based on codebases used by FP Complete for its corporate customers and internally for years prior. stack is a refresh of that codebase combined with other open source efforts like stackage-cli to meet the needs of users everywhere.

A large impetus for the work on stack was a large survey of people interested in Haskell, which rated build issues as a major concern. The stack team hopes that stack can address these concerns.