This Cabal Git repository contains the following main packages:

• Cabal: the Cabal library package (license)
• Cabal-syntax: the .cabal file format library (license)
• cabal-install: the package containing the cabal tool (license)
• cabal-install-solver: the package containing the solver component of the cabal tool (license)

The canonical upstream repository is located at https://github.com/haskell/cabal.

1. GHCup (preferred): get GHCup using the directions on its website and run:

   ghcup install --set cabal latest
   

2. Download from official website: the cabal-install binary download for your platform should contain the cabal executable.

Getting unreleased versions of cabal-install: gives you a chance to try out yet-unreleased features. Currently, we only provide binaries for x86_64 platforms.

1. GitHub preview release built from the tip of the master branch: download from GitHub or use this GHCup command to install:

   ghcup install cabal -u https://github.com/haskell/cabal/releases/download/cabal-head/cabal-head-Linux-x86_64.tar.gz head
   

   Replace "Linux" with "Windows" or "macOS" as appropriate.

2. Even more cutting-edge binaries built from pull requests are always available from the Validate worklow page on GitHub, at the very bottom of the page.

1. With cabal-install: if you have a pre-existing version of cabal-install, run:

   cabal install cabal-install
   

   to get the latest version of cabal-install. (You may want to cabal update first.)

2. From Git: again with a pre-existing version of cabal-install, you can install the latest version from the Git repository. Clone the Git repository, move to its root, and run:

   cabal install --project-file=cabal.project.release cabal-install
   

3. Bootstrapping: if you don't have a pre-existing version of cabal-install, look into the bootstrap directory.

cabal comes with a thorough User Manual. If you are new to cabal and want to quickly learn the basics, check Getting Started With Haskell and Cabal.

Got questions? Ask in Haskell Matrix (online chat) or Haskell Discourse.

Refer to CONTRIBUTING.md.