Hackage :: [Package]

ghcup: ghc toolchain installer

[ lgpl, library, system ] [ Propose Tags ] [ Report a vulnerability ]

A rewrite of the shell script ghcup, for providing a more stable user experience and exposing an API.

[Skip to Readme]

Modules

[Last Documentation]

  • GHCup
    • GHCup.Builder
    • GHCup.CabalConfig
    • Command
      • Compile
        • GHCup.Command.Compile.GHC
        • GHCup.Command.Compile.HLS
      • GHCup.Command.DebugInfo
      • GHCup.Command.GC
      • GHCup.Command.HealthCheck
      • GHCup.Command.Install
        • GHCup.Command.Install.LowLevel
      • GHCup.Command.List
      • GHCup.Command.Nuke
      • GHCup.Command.Prefetch
      • GHCup.Command.Rm
      • GHCup.Command.Set
      • Test
        • GHCup.Command.Test.GHC
      • GHCup.Command.Upgrade
      • GHCup.Command.Whereis
    • Compat
      • GHCup.Compat.Pager
      • GHCup.Compat.Terminal
    • GHCup.Download
      • GHCup.Download.IOStreams
    • GHCup.Errors
    • Hardcoded
      • GHCup.Hardcoded.URLs
      • GHCup.Hardcoded.Version
    • Input
      • GHCup.Input.Parsers
        • GHCup.Input.Parsers.URI
      • GHCup.Input.Prompts
      • GHCup.Input.SymlinkSpec
    • Legacy
      • GHCup.Legacy.Cabal
      • GHCup.Legacy.HLS
      • GHCup.Legacy.Stack
      • GHCup.Legacy.Utils
    • GHCup.PlanJson
    • GHCup.Prelude
      • GHCup.Prelude.Attoparsec
      • GHCup.Prelude.File
        • Posix
          • GHCup.Prelude.File.Posix.Traversals
        • GHCup.Prelude.File.Search
      • GHCup.Prelude.Internal
      • GHCup.Prelude.JSON
      • GHCup.Prelude.Logger
        • GHCup.Prelude.Logger.Internal
      • GHCup.Prelude.MegaParsec
      • GHCup.Prelude.Process
        • GHCup.Prelude.Process.Windows
      • String
        • GHCup.Prelude.String.QQ
      • GHCup.Prelude.Version
        • GHCup.Prelude.Version.QQ
    • GHCup.Query
      • GHCup.Query.DB
        • GHCup.Query.DB.HLS
      • GHCup.Query.GHCupDirs
      • GHCup.Query.Metadata
      • GHCup.Query.Symlink
      • GHCup.Query.System
    • GHCup.Setup
    • System
      • GHCup.System.Cmd
      • GHCup.System.Directory
    • GHCup.Types
      • GHCup.Types.Dhall
      • GHCup.Types.JSON
        • GHCup.Types.JSON.MapIgnoreUnknownKeys
        • GHCup.Types.JSON.Utils
        • GHCup.Types.JSON.Versions
      • GHCup.Types.Optics
      • GHCup.Types.Stack
      • GHCup.Types.Tar
    • GHCup.Unpack
    • GHCup.Warnings

Flags

Manual Flags

NameDescriptionDefault
tui

Build the brick powered tui (ghcup tui).

Enabled
internal-downloader

Compile the internal downloader, which links against OpenSSL. This is disabled on windows.

Disabled
strict-metadata-parsing

Don't ignore unknown keys in metadata. Useful for metadata testing.

Disabled
no-exe

Don't build any executables

Disabled
tar

Use haskell tar instead of libarchive.

Disabled
yaml-streamly

Use yaml-streamly instead of yaml (based on conduit)

Disabled
dhall

Add support for dhall encoded metadata

Enabled
Automatic Flags
NameDescriptionDefault
dhall-tests

Run dhall tests depedning on dhall-yaml/dhall-json

Enabled

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

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.14.1, 0.1.14.2, 0.1.17.2, 0.1.17.3, 0.1.17.4, 0.1.17.5, 0.1.17.6, 0.1.17.8, 0.1.17.9, 0.1.17.10, 0.1.18.0, 0.1.19.0, 0.1.19.1, 0.1.19.2, 0.1.19.5, 0.1.20.0, 0.1.22.0, 0.1.30.0, 0.1.40.0, 0.1.50.0, 0.1.50.1, 0.1.50.2, 0.2.1.0, 0.2.2.0, 0.2.3.0 (info)
Change log CHANGELOG.md
Dependencies aeson (>=1.4), aeson-pretty (>=0.8.8 && <0.9), async (>=2.2.3 && <2.3), attoparsec (>=0.14 && <0.15), base (>=4.12 && <5), base16-bytestring (>=0.1.1.6 && <1.1), binary (>=0.8.6.0 && <0.11), brick (>=2.1 && <2.13), bytestring (>=0.10 && <0.13), bz2 (>=1.0.1.1 && <1.1), Cabal (>=3.0.0.0 && <3.1 || >=3.2.0.0 && <3.3 || >=3.4.0.0 && <3.5 || >=3.6.0.0 && <3.7 || >=3.8.0.0 && <3.9 || >=3.10.0.0 && <3.11 || >=3.12.0.0 && <3.13 || >=3.14.0.0 && <3.15), Cabal-syntax (>=3.6.0.0 && <3.7 || >=3.8.0.0 && <3.9 || >=3.10.0.0 && <3.11 || >=3.12.0.0 && <3.13 || >=3.14.0.0 && <3.15), case-insensitive (>=1.2.1.0 && <1.3), casing (>=0.1.4.1 && <0.2), conduit (>=1.3 && <1.4), conduit-extra (>=1.3 && <1.4), containers (>=0.6 && <0.8), cryptohash-sha256 (>=0.11.101.0 && <0.12), deepseq (>=1.4 && <1.7), dhall (>=1.42 && <1.43), directory (>=1.3.6.0 && <1.4), disk-free-space (>=0.1.0.1 && <0.2), either (>=5.0.3 && <5.1), exceptions (>=0.10 && <0.11), file-uri (>=0.1.0.0 && <0.2), filepath (>=1.4.101.0), filepattern (>=0.1.3 && <0.2), ghcup, indexed-traversable (>=0.1.4 && <0.2), libarchive (>=3.0.3.0 && <3.1), megaparsec (>=8.0.0 && <9.8), mtl (>=2.2 && <2.4), optics (>=0.4 && <0.5), optparse-applicative (>=0.15.1.0 && <0.20), os-release (>=1.0.0 && <1.1), parsec, pretty (>=1.1.3.6 && <1.2), pretty-terminal (>=0.1.0.0 && <0.2), process (>=1.6.11.0 && <1.7), regex-posix (>=0.96 && <0.97), resourcet (>=1.2.2 && <1.4), retry (>=0.8.1.2 && <0.10), safe (>=0.3.18 && <0.4), safe-exceptions (>=0.1 && <0.2), scientific, split (>=0.2.3.4 && <0.3), strict-base (>=0.4 && <0.5), tagsoup (>=0.14 && <0.15), template-haskell (>=2.7 && <2.25), temporary (>=1.3 && <1.4), terminal-size (>=0.3.3 && <0.4), text (>=2.0 && <2.2), th-lift (>=0.8.7 && <0.9), time (>=1.9.3 && <1.17), transformers (>=0.5 && <0.7), unix (>=2.7 && <2.9), unix-bytestring (>=0.4 && <0.5), unliftio-core (>=0.2.0.1 && <0.3), unordered-containers (>=0.2 && <0.3), uri-bytestring (>=0.4.0.1 && <0.5), utf8-string (>=1.0 && <1.1), variant (>=1.0 && <1.1), vector (>=0.12 && <0.14), versions (>=6.0.5 && <6.1), vty (>=6.0 && <6.5), Win32 (>=2.10), witherable (>=0.4 && <0.6), word8 (>=0.1.3 && <0.2), xz (>=5.6.3 && <5.7), yaml (>=0.11.0 && <0.12), zlib (>=0.6.2.2 && <0.8) [details]
Tested with ghc ==9.14.1, ghc ==9.12.4, ghc ==9.10.3, ghc ==9.8.4, ghc ==9.6.7
License LGPL-3.0-only
Copyright Julian Ospald 2024
Author Julian Ospald
Maintainer hasufell@posteo.de
Uploaded by maerwald at 2026-05-21T15:05:37Z
Category System
Home page https://github.com/haskell/ghcup-hs
Bug tracker https://github.com/haskell/ghcup-hs/issues/
Source repo head: git clone https://github.com/haskell/ghcup-hs.git
Distributions
Executables ghcup
Downloads 3427 total (95 in the last 30 days)
Rating 2.5 (votes: 3) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2026-05-21 [all 2 reports]

Readme for ghcup-0.2.1.0

[back to package description]

The GHCup Haskell installer

Join the chat at Libera.chat Join the chat at Matrix.org Join the chat at Discord Join the chat at https://gitter.im/haskell/ghcup Donate

GHCup is the main installer for the general purpose language Haskell.

Visit the documentation for installation instructions.

Looking for something else?